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1.0 INTRODUCTION 


1.0 INIROQUCTION 


The NOS/VE Cycle 18 Software Release Bulletin (SRB) Is to be used 
with the NOS/VE Installation and Upgrade Manual (60463913) for 
Installing Control Bata Corporation systems. Control Oata recommends 
that the SRB be read in its entirety prior to software Installation. 


1.1 SCQPE 


The SRB Is the vehicle to document any changes to the Installation 
and Upgrade Manual after it has gone to print and any system 
deficiencies. It is necessary to Install NOS 2.2 Level 602 and Level 
587 of the Common Products before Installing NOS/VE. 


1.2 CONTENT 


This document contains Information to be used In Installing NOS/VE 
Cycle 18 with the Level 1V Product Set. Sections of this document 
include 1) Installing the systems 2) operating system notes and features 
Inctuding undocumented commands and known system deficiencies, 3) 
product set notes and featuress and 4) an appendix containing NOS/VE 
Peripheral Maintenance Support information. 
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200 EEATURES_AND PRODUCTS 


A description of Operating System and Product Set features may be 
found in the NOS/VE 1.0 Software Availability Bulletin (SAB). Please 
refer to that document for NOS/VE Cycte 18 system feature information. 


All references In the NOS/VE 1.0 SAB to the CYBER 176-835 and CYBER 
170-855 should be updated to include the CYBER 170-815, CYBER 170-8259 
and CYBER 176-845. <All references In the NOS/VE 1.6 SAB to NOS 2.1 
Level 588 should be modifled to NOS 2.2 Operating System Level 596 and 
Common Product Level 602. 


The release materials for NOS/VE Cycle 18 include the following 
software products. 


Product Name External Identification 
» NOS/VE Deadstart Generation and e NOS/VE =~ 01 
Modification Package 
« NOS/VE System Core and Job Template Memory » Meintenance 
Image Maintenance | 
2 COBOL for NOS/VE » NOS/VE - 62 
» SORT/MERGE Utifity | » NOS/VE - 03 
. Required Products « NOS/VE = 64 
e File Management Utility e NOS/VE = 05 
« FORTRAN for NOS/VE » NCS/VE - 06 
« CYBER Implementation Language | | « NOS/VE - 67 
« NOS/VE Gn Line Manuals e NOS/VE - 08 
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The list of NOS/VE Reference Manuals inctudes the following: 


Cperating System Manuals 


System Command Language for NOS/VE Language 
Definition Usage 


System Command Language for NOS/VE System 
Interface Usage 


System Command Language for NOS/VE + ontine 
Quick Reference 


Source Code Utility for NOS/VE + online 
Usage 


Cb ject Code Management for NOS/VE + online 
Usage 


CYBIL Manuals 


CYRIL for NOS/VE Language Definition Usage 
CYBIL for NOS/VE File Interface Usage 
CYBIL for NOS/VE System Interface Usage 


FORTRAN Manuals 


FORTRAN for NOS/VE + oniine Usage 


COBOL Manual 


COBOL for NOS/VE + online Usage 


Publication Number 


60464013 
60464014 
60464018 
60464313 


66464413 


Publication Number 


60464113 
60464114 
60464115 


Publication Number 


60485913 


Publication Number 


60486013 


Publication Number 


Language~Independent Tools/Uthiities Manuals 


File Management Utility for NOS/VE Usege 60486413 


Sort/Merge Utility for NOS/VE + online Usage 60486113 
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Math Library for NOS/VE Usage 60486513 
Famify Administration for NOS/VE Usage 60464513 
Migration Aid Publication Number 
Migration Guide for NOS to NOS/VE + online 66489503 | 
Error Massages Publication Number 
ivesnentie Messages for NOS/VE + ontine 60464613 
Site Manuals Publication Number 
NOS/VE Installation and Upgrade Usage : 60463913 
NOS/VE Operations Usage | 60463914 
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361 INSTALLATION 


Beil 
1. 


20 


Je 


3ele2 


1. 


NOS INSTALLATION 


The NOS User Name creation described in the NOS/VE Instatiation 
and Upgrade Manual implies that the default MODVAL OS vatue is 
adequate. 05=5 is the appropriate value. 

PSR NVO0011 


PASSON and IRHF both run out of the SYSTEMX account. Because of 
thiss, the password must be set to SYSTEMX and the resource 
validations must be set to their saximum. 

PSR NVGOD02 


The “UN=s* parameter on the *SETVE* command must have its resource 
validations set to the maximum. Fallure toe do this can cause the 
deadstart job to fail with "PRU LIMIT* or *SRU LIMIT®,. 

PSR NVOODOZ2. 


CONTROLWARE INSTALLATION 
To Install the 7155 Disk controlware the following process must be 
followed: 


ae Copy the Controlware card deck to diract access file FMDBIN 
jin a NOS user number. 


be Create indirect access file CWFMD containing the tine 


*COMMENTDPPU/FMDbDS8SbFIRMWARE DMA7 21~-A09( PN67185349) bYY/MM/DD 
where b represents a space and YY/MM/DD should be filled In 
with the appropriate date. 


ce Return both files. 
gd. Create File GENFMD contalning the following procedure: 


PROC» GENFMD, 

GETsCWFMD. : 

ATTACHs INHOLD=FMDBIN. 

REWIND, INHOLD. 

RFL»50000. . 

RBRCINHOLDsFMD) (the second argument here must match the PP 
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name In the comment card) 
WBRILGOD) 
LIBEDIT(P=LGO» B8=05 IT=CWFNDs»L=Cy»N=FMD) 


@e Run this procedure from the NOS terminal. Note that this 
sequence of commands must be run as a procedure and will not 
work if typed In as Individual commands at the terminal. 


f. The resuitant fiie FMD may be saved or written to tape and 
made part of the NOS Deadstart tape via Libedit or Sysedit. 


301.3 INSTALLATION OF LARGE SECTOR FMD DIAGNOSTICS 


Installation of the CNL L166 can be done the same way CML 11155 was 
installad with the addition of the 8851S parameter. The Installation 
process Is described in Section 1 of the CML Referance Manual 
publication 60455980,» Rev.K. The parameter 8B85LS for large sector 885 
disk drives is dascribed belowe The device code for 885 large sector is 
16 octal. 


(This item joes with Table 1-3 Hardware Configuration Parameters 
sheet 3 of 3 on paye i-19 of the above mentioned CML Reference Manual. 


Parameter Name Used In Job Function 

BB5LS CML2s9CML5 Specifies that targa sector 
885 disk drives are included in 
the system configuration. Causes 
MALET diagnostics FLO and OL8 
to be loaded and saved. Will also 
cause FMC and FMU to be loaded 
and saved if not done through the 
Inclusion of other parameters. 

(7155/885/DEMH). 


301.4 NOS/VE INSTALLATION 


1. The description of Release Materials in section 1. of the 
Installation Handbook for NOS/VE 1.9.2 is incorrect. 


The tape described as NOS/VE-04 Is actually tabelled PRopUcTS 9 
but still. contains the required NOS/VE products. 


The tape labelled NOS/VE-04 contains the Ontine Manuals and is an 
optional tape. It is a 180 tape written by the 
Backup Permanent Flies utility and contains 15 files «© which 
comprise the $SYSTEM product subcatalog. They are loaded via the 
Restore Parmanent_Files utifity. 
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2e Several operational problems have been encountered by sites when 
maintaining thelr S$SYSTEM.SSYSTEM files using the 
BACKUP_PERMANENT_LFILE and RESTORE_PERMANENT_FILE utilities. These 
problems occur due to various files which are created during 
NOS/VE deadstart. The problems which arises and the appropriate 
remedial action are described below: 


a» Circumstances arlse where an INSTALLATION deadstart is 
necessary foilloned by restoration of the permanent file base 
using the RESTGRE PERMANENT FILE utility. When deadstart 
has completeds the folloning permanent files may have been 
creatad: 


uuueSFAMILY_LUSERS - This file is created during processing 
of the Initialization prolog. The content of this file 
typically does not match the current validation contained 
on a site's archived permanent file base. Remedial action: 
See the next Item in this section describing the required 
remedial action. 

PSR NVO0118 


SYSTEM_LPROLOG and SYSTEMLEPILONG =- These filles are aiso 
created during Initiatization prolog processing. 
Corresponding SUPPLEMENT filles are created as well. Any 
changes a site may have made to these filles which reside In 
catalog SSYSTEM.PROLOGS_AND_LEPILOGS will be lost. Remedial 
action: Untill adequate provisions sere made for maintaining 
and upgrading thase files», it is recommended that the 
famiiy user administrator provide user prolog and user 
epllog files which reflect the processing parformed during 
user LOGIN and LOGOUT. These user prolog and epilog files 
are associated with familly users by the SETLUSER PROLOG and 
SETLUUSER_LEPILOG commands of the ADMINISTER_LUSER utility. 
PSR NVOOC24 


System Libraries - These files are created from files 
loaded from the NOS/VE deadstart fiie whenever the system 
core commands INITIALIZE _DEADSTART_DEVICE or 
SETLSYSTEM_LATTRIBUTE LOADFILES 1 are processed. They 
include the following files: 
SSSYSTEMSSSYSTEM~OSFSNPERATOR_LIBRARY.~SNEXT 
SSSYSTEMLSSYSTEM-OSFSOPERATOR_ COMMAND_LIBRARY.»SNEXT 
SSSYSTEM»SSYSTEM-OSFSCOMMAND_LIBRARY.»SNEXT (Boot Version) 
TSESYSTEM.SSYSTEM.OSF 3 $SYSTEM. SSYSTEM_LIBRARY.SNEXT 
t$SYSTEM.SSYSTEM.OSFSSITE_COMMAND_LIBRARY. SNEXT 
SSSYSTEM.SSYSTEM-CYBIL CYFSRUN_ TIME_LIBRARY.SNEXT 
tSSYSTEM.SSYSTEM.OCU. BOUND_PRODUCT.SNEXT (Boot Version) 
Any changes to these files must also bea made to NOS/VE 
deadstart files otherwise they will be lost when NOS/VE is 
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deadstarted. Operational problems arise with the filles 
Identified above as "Boot Version™ files. These “Boot 
Version” files contain sketetal versions of the system 
command tlbrary and Object _Code_Utitities which are 
required for deadstert to complete normally. The fully 
Installed version of these files Is required for normal 
NOS/VE usage. Since these files are created during 
deadstarts, they will not be restored during subsequent 
execution of the RESTORE _PERMANENT_FILE utility. Remedial 
action: Either rerun the RESTORE  PERMANENT_FILE utitity and 
specify the RESTORELEXISTING_FILES directive for these 
files; or specify SET_LSYSTEM_ATTRIBUTE LOADFILES 1 and 
SET _SYSTEM_LATTRIBUTES MULTD 1 during a CONTINUATION 
deadstarts and reload the NOS/VE required products tape 
when the NEXTDSTAPE response Is requested. 
be When any of the system tibraries have changed on the NOS/VE 
deadstart Files it is necessary to specify 
SETUSYSTEMLATTRIBUTE LOADFILES 1 during a CONTINUATION 
deadstart. Again» the “Boot Version” files are created 
which are inappropriate for a production workload. Remediat 
action: Either delete cycte $HIGH of the "Boot Version" 
flless or specify SETLSYSTEM_LATTRIBUTE BMULTD 1 and reload 
the required products tape when the NEXTOSTAPE response is 
requested during deadstart. 


The problems associated with "B8e0t Version™ files will be 
corrected In a future release. 
PSR NV006077 


3. Automated vaillidation performed during an INSTALLATION deedstart 
creates a $FAMILY_USERS file for the NVE family. If you 
subsequentiy reload permanent files to famiiy NVE from a 
BACKUP _PERMANENT_LFILE flles catalogs which were not defined In the 
automated validation cannot be accessed. Likewises any catalog 
information which has not bean updated in the automated validation 
file is Incorrect for the catalogs restored using 
RESTORE PERMANENT_FILE. The recommended sequence of events in 
which an Installation deadstart can be performeds and the family 
NVE permanent files restored from a previous fevel is as follows: 


ae BACKUP_PERMANENT_LFILE all NVE catalogs and files to tape iin 
a task that runs In ring 3 from a Job other than the system 
job {console) that runs under S3SYS5TEM. This is done by 
bracketing the commands assoclated with the backup with 
TASK, TASKEND commands. The ring number is established by 
using the RING parameter of the TASK command. For examples 

type from the consoles 

JOBs BACKUP 
REQMTsDUMP » o. 
T=MT9/ 462509 RING=OQNSEVSN=(/*017*) 
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TASKsRING=3 
BACPFs BF=DUMP 
BACAF 
QUIT 
TASKEND 
JOBEND 
NOTE: The task command can be specified onty in an 
interactive Job or in a batch Job running under S$SYSTEM. 

be Perform an Instatletion Deadstart of NOS/VE» but enter the 
command GO rather than AUTO to terminate System Core command 
processing. An additional pause for operator intervention 
occurs just prior to the loading of system Jibraries from 
the NOS/VE deadstart file. Enter the command DETF 
VALIDATE/OFAMILY/ONVE prior to entering the NEXTDSTAPE or 60 
response which causes deadstart processing to resume. This 
command will disable automated validation. 

Ce Restore the $FAMILY_USERS file that was backed up in step a. 
(If you falted to disable vatidation prior to this steps you 
must LOGIN as the NVE family user administrators and change 
the " name of the SFAMILY_USERS file using 
Change Catalog Entry.) 

4. Restore the remaining NVE family files which were backed up 
in step i. 

@., Execute the Create_ Family command from the operator console 

PSR NVOOD79 


The procedure Verlify_Instatled_ Software which is documented In the 


NOS/VE Installation and Upgrade manual {Publication number 


60463913 A) Is not avallabie at this time. 


Multipie NOS/VE gupgrades using the CREATE_JOB_LTEMPLATE command 
result in a large number of files being created on the deadstart 
disk. Each successful execution of the CREATE_JOB TEMPLATE 
command creates a directory file and several uniquely named 
segment files. The directory file name ts specified by the 
TEMPLATE_NAME parameters and contains the name of every segment 
file which constitutes the job template. Whenever a job template 
Is no longer being useds the DELETE_JOB_L TEMPLATE command should be 
used to remove the directory file from the deadstart disk. 
Segment files are removed by this command whenever the directory 
file is removed. The console entry for this command is? 


KeDELETE/OJOB/OTEMPLATE TN=name 
PSR NVGO0023 


Online manuals are released on a NOS/VE BACKUP_PERMANENT_FILE tape 


at this release. Ina Future release of NOS/VEs» all products will 


be released in this format. To instal! the online manuals at this 
release levels you must retoad the files on this tape into the 
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S$SYSTEM.-MANUALS subcatalogs of the $SYSTEM family. Create the 
following NOS/VE job to accomplish this task: 


JOBs RESTORE 
request _magnetic_tape filie=backup type=mt9$1600 .. 
ring=no evsn=nvedd4s 


WHEN any fault DO 
display_vatue osv$status output=$response 
request_operator_action messages" RESTORE FAILED —- CHECK TAPE? 
LOGOUT 

WHENED 


RESTORE PERMANENT_FILE 
restore _allifiles backup _file=zbackup 
QuIT 


JOBEND 


The above job may be created as a NOS or NOS/VE text File. This 
text file is then accessed from the operator consoles using the 
ATTACHLFILE or GET_FILE commands and the INCLUDE_FILE command is 
executed to submit this job as a SSYSTEM family batch Job. 


Remote [Installation and maintenance of the operating system 
requires assistance from the operator's console. The installation 
and maintenance procedures are being modified to reduce the need 


for assistance at the console. Until Remote Deadstart is 


avallables this need will not be totally etiminated. 


In cycle 16 and earliers the user_prolog and user_epiiog entries 
for validated users contain the following: 


user_prolog="include_file $systemeprologs_and_ep!logs.user_prolog! 
user_epilog="include_file Ssystem.proftogs_and_epilogs.user_epilog? 


In cycle 17 and taters the user _prolog and user_epliiog entries 
must now contain the following: 


usar_prolog = '$user.prolog? 
user_epilog = 'Suser.epilag* 


Users validated in cycles below 17 must have the entries changed 
to the above mentioned Information by the Family Administrator. 


The VALIDATE_LUSER procedure has been modified to accomodate the 


change. Those users created using this procedure in cycle 17 or 
later willl have the correct Information for the user vprolog and 
user _epilog entries. | | 
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There has been a change to the type of value supplied as parameter 
tao the SET_LUSER_ PROLOG and SETLUSERLEPILNG subcommands = of 
ADMINISTER_USER. The change Is as follows: . 


setluser_prolog prolog='"<file_reference>! 
set_user_epifog eplilog="<file_reference>*® 


Recall from the Installation and Upgrade manual that to advance to 
a new NOS/VE system and have the NOS/VE permanent file base 
Intacts it Is necessary to Install the system and recovery job 
tampliate from the new system using the old system. <After the 
templates have been Installeds the terminate_system command is 
used to bring the system down. Recall aiso that as soon as the 
system has terminated» another deadstart of NOS/VE (recovery 
deadstart) occurs automatically. It {fs essential that this 
recovery deadstart be allowed to compieted for the oid system 
because this recovery deadstart ts the checkpoint of the 
previously running system (1.@es permanent files are updated to be 
consistent with memory contents at termination and deadstart 
termination status Is recorded). 


An experienced installation anatyst may realize that tf the 
recovery deadstart following termination is not aitowed to 
completes, a recovery deadstart will be automatically initiated 
when the next continuation deadstart Is attempted. If the 
recovery deadstart following termination for the old system Is not 
allowed to completes the new system (cycie 18) will be unable to 
deadstart and the old system will have to be deadstarted to aliow 
recovery to properly complete. 


3.2 NOS/VE_EXECUTIVE 


1. 


NOS/VE will not support more than 10 tasks concurrently defined 
per Job. The system does not enforce this limit; users must be 
careful not to axceed this limit or they may cause the system to 
fall. 


363 QREBATOR_CONNANDS 


1. 


Restarting IRHF and IFEXC on the 180 Side 


IRHF should automatically restart if it aborts. There is a 
constant check to see if it has aborted. To bring up IRHF 
manuallys the operator must first bring down IRHF»s then bring it 
up again. The same holds true for IFEXEC. 
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To bring down IRHF, type In at the 180 NOS/VE operator's console: 


KeDEACTIVATE/OSYSTEM/OTASKS TASK/ONAMES=RHINPUT 
KeDEACTIVATE/OSYSTEM/OTASKS TASK/ONAMES=RHOUT PUT 


Then to bring IRHF back ups type in at the 186 NOS/VE operator's 
console? 


K eACTIVATEZOSYSTEM/OTASKS TASK/ONAME S*RHINPUT 
KeACTIVATE/OSYSTEM/OTASKS TASK /ONAME S =RHOUT PUT 


To bring down IFEXECs type In at the 180 NOS/VE operator's 
console? 


K eDEACTIVATE/OSYSTEM/OTASKS TASK/ONAMES=IFEXEC 


Then to bring IFEXC back UPS type in at the 186 NOS/VE operator's 
console? 


KeACTIVATE/OSYSTEM/OTASKS TASK/ONAME =IFEXEC 
PSR NVO00032 
Restarting IRHF and PASSON on the 170 Side 


To make provisions for restarting IRHF and PASSON»s a site analyst 
or an operator should create two procedures and save each one on 
an indirect permanent file that is located under user index 
37777756 


Procedure 1. The file name should be MSSIRHF and should took tlike 
this: 


oPROCaMSSIRHF. 

COMMON»s SYSTEM. 
GTR»oSYSTEMsNVELIBsUsULIB/NVELIB 
UNLOAD» SYSTEM. 

LIBRARYsNVELIB. 

RUNJOBS CIRHF) 


Procedure 2 The file name should be MSSPASS and should lock like 
this: 


COMMON» SYSTEM. 
GTRseSYSTEMsNVELIBsUsULIB/NVELIB 
LIBRARYsNVELIB. 
RUNJOBS (PASSON) 


Once these are in user Index 377777B» IRHF is restarted by simply 
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typing the following In at the 170 operator's console: 
MSSIRHF. 

PASSON is restarted by typing In at the 176 operator*s console? 
MSSPASS.. 

PSR NVOO0016 and PSR NVOE2Z93 


The NOS application (VEIAF) that connects NOS/VE jobs to NAM will 
sometimes produce the flashing console message: 


"PASSON ABNORMAL 18” 


This message means PASSON is discarding an unsolicited message 
generated between VEIAF and the first read request from NOS/VE. 


This should be ignored. Clear the message with 'GOsJsn.°* 


224 CONFIGURATION. NANAGENENT 


le 


2e 


3e 


4 


The INITIALIZE _DEADSTART_DEVICE system-core command and the 
INITIALIZE_MS_ VOLUME Logical Configuration Utility subcommand do 
not warn the operator that the volume has been previously 
initialized. This is of particular concern In 
INITIALIZE_MS_ VOLUME because the operator may misspell the 
element name of the device and inadvertentiy destroy permanent 
files. 


If the physical configuration consists of one channels one mass 
storage controtters and one mass storage units one can describe 
this initially using system-—core commands. However» this 
configuration needs to be redescribed using Physical Configuration 
Utility and Logical Configuration Utility subcommands in order to 
gat through an installation deadstart. 


For optimal system performance all NOS/VE disk units should be 
defined during the instal! deadstart. This is important so that 
all of the tfegical configuration Is available for allocating 
product set files, 


During recovery when operator Intervention has been specified, the 
logical configuration utility <(LCU) Is Invoked both before and 
after the configuration transition. The first Invocation allows. 
the operator to change which elements in the physical 
configuration are logically configured. The second Invocation 
allows the operator to Initialize and add volumes to the system 
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8. 


sete This is useful If the first invocation of the LCU happens to 
add one or more volumes to the logical configuration. 


The abilltty to invoke the LCW during a continuation deadstart as 
described in the previous bullet has been added. 


The physical configuration utitity subcommands 
INSTALL UPHYSICAL_CONFIGURATION has a new parameter, 
PHYSICAL_CONFIGURATION. This parameter specifies the name of a 
focal file that will receive information about the physical 
configuration being debugged. Use of this parameter will cause 
the configuration to NOT be Installed. The file produced by this 
command can be used as input to the INSTALL LOGICAL CONFIGURATION 
subcommand of the logical configuration utility. The abbreviation 
for PHYSICAL_CONFIGURATION is PC. 


The logical configuration utility subcomman ds 
INSTALL _LOGICAL_ CONFIGURATION has a new parameter » 
PHYSICAL_CONFIGURATION. This parameter specifies the name of a 
tlocal fille that wlll provide information about the physical 
configuration being debugged. Use of this parameter wil! cause 
the configuration to NOT be Instalted. The abbreviation for 
PHYSICAL_CONFIGURATION Is PC. 


A new keyword has been added to the command tabie for the 
SETLUSYSTEM_LATTRIBUTES commands, SUSPENDED _JOBLTIMEDUTLLIMIT. It 
provides the capability to change the timeout timit for detached 
interactive jobs via the SETSA command by entering: 


SETLSYSTEMLATTRISUTES Ne=SUSPENDED_JNB_TIMEQUT_ LIMIT V=ennnnannn 


where nannnannn represents mlitiseconds and has a valid range of 
690000 - 108906000 (10 minutes ~- 3 hours). 


NVOE528 


305 DEVICE MANAGENENTZRECOVERY 


le 


If any disk volume being used by NOS/VE becomes fulls the 
following message will periodicaily appear on the MDD screen? 


AAAAAA ~ volume out of space 
(AAAAAA tis the vsn of the volume) 


Any task that is requesting space on a full volume will hang 
walting for space. Some space may be obtained by asking users (if 
they are able) to delete permanent files and detach local files. 
If the disk full condition persists, the NOS/VE system should be 
taken down and brought back up. This action wit! release most of 
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the temporary file space that was In use. If the disk full was 
caused by permanent files» then the disk will be nearty full after 
the recoverys and some actlon--such as backing up permanent files | 
and deleting some files--must be taken immediately. 


It ts possible that a disk full situation will occur that cannot 
be recovered. This will have happened If the “volume out = of 
space” massage appaars during a deadstart before the system is up. 
In this case case permanent fife volumes must be iInitiatized and 
reloaded from a previous backup dump. 


If ae continuation deadstart fails after disk full with ea 186 CPU 
monitor faults it Is possible that the falture Is due to unprinted 
files in. the output queues one or more of which are no ftonger 
printable. The fallure is a Job mode software failure and does 
not jeave the ACR set In moniter mode. The message indicating 
this fallure is “HR - MONITOR FAULT”. 


Corrective action: 


On the next attempt at a continuation deadstarts, enter the 
following command when the system asks for operator supplied core 
commands: 


SET-SYSTEM_ATTRIBUTE HALTRING 0 


This command wii! allow deadstart to complete. If», at this times 
you find that task RHOUTPUT has terminated (by looking at the 
System job log by doing a DISSL)» and fites exist in the Job 
output queue {(DISPLAY_CATALOG $SSYSTEM.%SJ0B_OUTPUT_QUEUE) you can 
be reasonably sure that you have encountered this problem. 


Detete the contents of the job output queue (DELETE 
CATALOG_CONTENTS $SYSTEM.s$JOB_OUTPUT_QUEUE), terminate NOS/VE» and 
do another continuation deadstart. 


When recovering without a memory images the EQI for a file is set 
to the highest allocation-unit which has been [nitiatized on the 
device. This is probably not what the actual end-of-information 
(ENI) shows. In the memory image. The file's owner Is not informed 
that a different ENI has been chosene This means that the user 


cannot use BAM to read the fife. The file needs to be recreated. 


PSR NVOE524 


306 INTERACTIVE 


le 


When using X25 to access NOS/VE» a terminal may intermittently 
hang allowing no input or output. TIP commands break {such as 
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escape~CH) out of this problem. This Is a CCP probtem that hes 
baen PSRd and corracted In CCP. 
PSR CC5A230 


367 PERMANENT_EILE_UTILITIES 


1. There is a timing problem/data sensitive bug that may 
occassionally cause the RESTORE_LPERMANENT_FILE command to abort. 
If this occurs, the operator should restart RESTORE with the 
falling reel. If the problem does not re—occurs only one file is 
lost. If the problem still occurs» restart RESTORE again but with 
the reel that follows the falling reel. In the second cases all 
files on the tape following the polnt where the failure occurred 
are lost. | 
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4-0 OPERATING. SYSTEM_NOTES AND. CAUTIONS 


401 SYSTEM COMMAND LANGUAGE 


le 


Re 


3» 


4. 


Se 


A command that depends on the “path name™ for a file is affected 
if the file has been explicitiy attached (attach files create file 
commands). 


The "path name™ that such a command wili encounter is the “local 
path name" rather than the path specified when the command was 
called. For examp!e: 


ATTACH_FILE SUSER.X LFN=Y 
REPLACE_FILE SUSER.X 


will result In a File called Y being referenced in reali state 
rather than Xe Users shoutd not mix implicit and expticit 
attaching of a file. 

PSR NVOD7T53 


The $PROGRAM function does not return the open position designator 
for the LOAD MAP file. 
PSP NVOD483 


The SETLUSENSE_SWITCH (SETSS) command wilt not accept a "user 
suppiied job name" but will onty work when given a “system 
supplied job name™, 

PSR NVOD871», PSR NVOD388B 


The constants $MIN_LINTEGER and $MAX INTEGER have vaiues of 
—-(2**48-1) and 2**48<1» respectivelys rather than -(2**63) and 
2**63—1. | 

PSR NVOD6O9 


A new display loption has been added to the display _catatog and 
display _catalog_entry commands. For the former command = this 
disptay option is called CONTENT(S) or C3 and for the latter 
command it is called CYCLE(S) or C. Also»s a parameter catiled 
DEPTH has been added (following the output) paramater) to both 
commands that works In conjunction with the added display options. 


 Thase options show the amount of space occupied by catalogs» 


filess and cycles. The depth parameter determines the tevel of 
detail that is displayed. 


DEPTH=1 gives ail tine summary of the catalog (or file). DEPTH=2 
{the default) glves a breakdown of filles and subcatalogs contained 
directiy ina catalog {or the cycles of a file). <A DEPTH greater 
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than 2 tis only applicable to catalogs and specifies ai further 
breakdown of the catalogs and fiies contained within the 
subcatalogs of the cataloge To get complete information about ail 
subcatatogss» files and cycles contained In a catalogs specify 
DEPTH=ALL. These changes did not make it into the manuals. 


6 The ACCEPT_LINE command now has an optional LINE_COUNT (LC) 
parameter which can be used to specify an SCL integer varlabie to 
receive a count of the lines read by the command, 


The $FILE function now supports the GLOBAL_FILE_POSITION (GFP) 
attribute. The values for this attribute are described under the 
DISPLAY _FILE_ATTRIBUTES command. A GLOBAL_FILE_POSITICN attribute 
value is returned by the function as a string with ali letters In 
upper case. 


These facilities can be used to detect EOI (End-Of—Information) 
when reading a file by means of the ACCEPT_LLINE command. 


7. Any files created by the program interface cannot be displayed 
with DISC $LOCAL. For examples the default files created in 
FORTRAN do not appear when subsequentiy entering DISC $LOCAL. 

PSRs NVEAO52s NVEAOD55» NVEAQ56 


8. JOB/JOBEND. does not work properly when §t encloses commands or 
text containing semicolons, All semicolons eppearing at 
end-of-iine are wrongly deleted; embedded semicolons are retained 
however. This probiem means that JOB/JOBEND cannot be useds (for 
examples to compile a  CY8IL programs, because the source code 
(assumed to be within a COLLECTITEXT) will have its semicolon 
delimiters stripped away; the complier then issues hundreds of 
error messages. Use LOGIN/LOGOUT to avoid the problem. 

PSR NVOFO690 . 


41.1 ADDITIONAL COMMANDS (NOT IN MANUALS) 
4elelel DISPLAY COMMAND PABAMETER(S)_(O1SCe) 


This command displays information about the parameters for a command. 
The information includes the names of the parameterss their types 
{including allowed keyword values) and thelr default values (or an 
indication that the parameter is required). 


This command Is not intended to be a repiacement for information tn 
on-line manualiss but rather a “memory jogger" for any command. It will 
work for any command that could be calted at the point where this 
command is called (including system supplied commandss SCL proceduress 
user programs and utility subcommands). 
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4elelel DISPLAY _COMMAND_PARAMETER(S) (DISCP) 


This command can be used to obtain Information about the paremeters 
for any command that uses SCL servicas to parse its parameters. 


display command parameters command=<command> 
Coutput=<file reference>} 
Cstatus=<status variable>] 


command : c: This parameter specifies the command for which information 
about parameters is sought. 


output §$ o: This parameter specifies the fite to which the parameter 
Information Is written. Omisston will cause S0UTPUT to be used. 


status: This is the standard status parameter. 


4e1.2 ADDITIONAL FUNCTIONS (NOT IN MANUALS) 
4ele2.1 SCOMMAND SOURCE 


This function is used to determine where the processor for the 
requesting command was found.» The source (filte or catalog) of the 
command ts returned as a string. 


By its nature, this function isn't particularly useful when used in 
the expression for a parameter to a commands sinces in that cases it 
will return the source of that command. Therefores this function ts 
normally used in an assignment statement. . 


<$command source> i322 $COMMAND SOURCE [<> <)>] 


Example? "The following proc resides on an" 
“object library in some catalog.™ 
PROC samp!le_command 
cs = $command source 
cat = $path ($fname(cs)s catalog) 
execute_task $fname(cat//*.sampla program) 
PROCEND 


4ele2o2 SPREVIOUS STATUS 


This function is used to obtain the completion status of the previous 
command. 


<$previous _status> 2:32 SPREVIDUS_STATUS [<> <)>] 
Example: collect text display ustatus 
: PROC display_status» diss ( 

status: status = previous status) 
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display_value Svalue(status) 
PROCEND display status 

** 

create _variable s kind=status 

create_variable x status=s 

display status 

NORMAL STATUS 

create _variable x status=s 

display status 
7 —ERROR—— X is already declared as a variable. 


4e1+2-3 S$QUDTE 
This function is used to quote a string. 
<$S$quote> i232 SQUOTE <> <string exprd> <)> 


Example: s = *ABC**DEF?® 
a = $quote(s) 
display value s 
ABC 'DEF 
display value q 
TABC P IDEF! 


4ole204 $SCAN_ANY 


This function is used to search a string for any one of a set of 
characters and return the index In the string of the found character. 
If no character from the set appears in the strings zero is returned. 


<Sscanlany> 222 $SCANLANY <(> <char set> “<sisp> 
<string expr> <)> 


<char set> 3:32 <string expr> 
Example: digits = 10123456789! | 


s = *TEMP_32" 
display value $scan_anyl(digitss s) 
6 


4e1e205 SSCAN_ANOTANY 


This function is used to search a string for any character that is 
not in a $set of characters and return the Index in the string of the 
found character. If only characters from the set appear in the strings 
zero Is returned. 
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<$scan_notany> 3:2 $SCAN_LNOTANY <> <char set> <sisp> 
€string expr> <)> 


<char set> 32 <string expr> 


Examples: digits = '0123456789! 
s = 'TEMP_32! 
display value $Sscan_notany(digitss s) 
1 


4e1e206 SSCAN STRING 


This function Is used to search a string for another strings called 
the patterns and return the Index of the first character of the pattern 
in the string. If the pattern is the null strings one Is returned. If 
the pattern Is not found in the strings zero is returned. 


<$scan_string> %2?= SSCAN_LSTRING <> <pattern> <sisp>d 
€string expr> <)> 


<pattern> 3:32 <string expr> 


Examplet s = *123_abc_9' 
p = "abc? 
display_value $scan_string(p»s s) 
5 


4.1.2.7 SIRANSLATE 


This function is used to change characters In a string according to a 
translation tabie. The translation table is a string of 256 characters 
which is utilized according to the following algorithm. 


result = Tt 
for | = 1 to Sstriantstring) do 
J = Sord($substr(strings 1)) 
result = result // Ssubstr(tabie, j+1) 
forend 
Two standard translation tables are provided. Use of LOWER _TO_LUPPER 
{LTU) produces a string with all lower case letters transiated to their 
upper case counterparts. Use of UPPER_LTO_LLOWER (UTL) produces a string 
with all upper case tetters translated to their lower case counterparts. | 


<$transtate> t2= $TRANSLATE <{> <transiation tabte> <sisp> 
. <string expr> <)> 


<transtation tabie> s:= <string expr> 
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3 LOWER_TOLUPPER ¢ LTYU 
2 UPPERLTOLLOWER & UTL 


Example: display value $transiate(lower_toluppers %123_abc*) 
| 123_AaC 


4e.1.2.8 S$IRIM 


This function is used to remove tralling space characters from a 
stringe | 


<$trim> 3:32 STRIM <> <string exprd> <)> 


Example: s = 'STRING * 
display_value "<*//7s//'*>* 
<STRING> 
display _value '<*//$trim(s)//%>? 
<STRING> 


401.3 ADDITIONAL CONTROL STATEMENTS (NOT IN MANUALS) 
4012321 PUSH COMMANDS 


<push commands> 3:= PUSH COMMANDS 


The purpose of this statement {is to cause the source (file or 
catalog) of the Issulng command to be pushed onto the top of the 
"dynamic command tist™. The entries in the dynamic command list are 
searched after the commands belonging to any active utilities send before 
the command tlist entries manipulated by the SET_COMMAND_LIST command. 
The effect of this statement is removed (popped) when the issuing 
command terminatess 


402 PERMANENT_EILES 


1. The DISPLAY CATALOG and DISPLAY CATALOG_ENTRY commands»s when used 
on a catalog or file owned by another users, should onty provide 
information for catalogs and/or files that the requesting user is 
permitted to access. This restriction is not enforced. The 
information erroneously provideds howevers does not include 
passwords and only contains tog entries and permit entries that 
apply to the requesting user. . . 

NVOE251 
NV0B133 
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4.3 REMOTE YOST 


le 


1. 


2e 


When the NOS/170 IRHF is started via a DIS job (for debugging 
IRHF)s It does not transmit queue files to NOS/VE. RUNJOBS is 
unable to acquire the queue file from NO$/170. See Section 3.3 of 
the SRB for a method of restarting IRHF. 


When a bad LOGIN command is present In a batch jobs the job 
disappears and printout with the error is received by the user to 
report the problem. This occurs when sending a Jjob from NOS to 
NOS/VE via ROUTEsxxsDC=LPsFC=RH. 

NVOE491 


Changing passwords on NOS and NOS/VE. 


In NOS 2.29 there are two passwords for each usere One is the NOS 
interactive job password and the other is the NOS batch job 
password. The NOS interactive Job password Is used while working 
on a terminal. It is also used for NOS/VE login processing - when 
fogging into NOS/VE on an Interactive terminals there is no check 
made of the NOS/VE password for validation purposess just the NOS 
interactive job password. Changing your NOS/VE will affect onty 
your NOS batch password. Your NOS/VE password must match your NOS 
batch password otherwise Remote Host wili not work since it 
submits batch jobs to NOS. 


Note 3: When using the SETLLINK ATTRIBUTES commands the NOS/VE 
Password specified must match the NOS batch job password. 


Note : The selection of passwords for NOS and NOS/VE must conform 
to the definition as given In the NOS Reference Manual for the NOS 
password and the NOS/VE Command Interface Reference Manual for the 
NOS/VE password. You have to take the common parts of both 
definitions to make a password that works for both NOS and NOS/VE. 


To change your NOS/VE passwords enter the SETLPASSWORD command on 
the 180 side 3 


Setpw oldpw newpw 


where oldpw Is your current NOS/VE password and newpw is the new 
Password... 


To change your NDS batch Job passwords you will have to submit a 
NOS batch job. Login to the 170 side and create a file to submit 
this job. the file should contain the following: 


JOBCARD. 
USER (usarnams user pw) 
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CHARGE» * . 
PASSWORD (user pwsanen pw) 
END 


where usernam is your usernames userpw is your current NOS batch 
Passwords and newpw is your new NOS batch password. Your original 
NOS batch password is set to your originat NOS interactive job 
passwordse All of the above commands in the file created must be 
typed in capital tetters. 


To submit this jobs type in : 
submits ifnsb.s 
where ifn is the fille you created. 


In order to change your NO5 interactive job passwords type in on 
the 170 side : 


Passwor ,oldpwsneawpw. 


where oldpw is your current NOS Interactive password and newpyu is 
your new interactive Job pessword. 


4.4 PROGRAM _ MANAGEMENT 


le Loading files into multiple rings may cause improper ring 
attributes to be assigned. 
PSR NVOC789 


2e The file position specifier is ignored when mentioned on SETPA. 
For examples specifying SETPA DEBUG_OUTPUT= SLIST.SEOI will cause 
debug to overwrite the $LIST file from its BOI position (not EOI 
as expected). 
PSR NVEAQ36 


5 PYYSICAL_I/0_{TAPE) 


1. Tapes are generally available for use In a single or multi~volumes 
uniabelled file anvironment. Copy fite of multiple files to a 
single tape produces undefined resultss howeverse 
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4.6 BASIC ACCESS METHOD 


1. 


2e 


36 


4e 


De 


bs 


Te 


8. 


The SET_WORKING_CATALOG (SETWC) command has no effect upon files 
whose names are created within applications. For example: 


SETWC ajl 
execute task 
task generates file name a 


The path name of the file Is not zajleas it is S$local.a. QOniy 
actual parameters of a command are subject to SETWC direction. 
PSR NVEAOQ2?7 


The preset value File attribute Is not supported. 
PSR NVO0B204. 


File attribute MIN_RECORD_LLENGTH Is not set properly for 
record type F files. MINURECORD LENGTH should be set to 
MAX RECORD ULENGTH If it is allowed to defaults but it is currently 
defaulting to 9%. This affects SORT/MERGE when the sort key Is 
omitted and the default is taken. 

PSR NVOD398 


If more than 100 Instances of OPEN exist concurrently within a 
Single tasks en ameSiocal_file.limit message is issued. The 
message indicates erroneousty that 1520925 local files Is the limit 
which was exceedad. The massage should say that only 160 
Instances of open nay exist concurrently In a task. 

PSR NVOD856 

PSR NVO0D632 


Skipping forward/backward by records and partitions does not 
always report the encounter with boundary conditions with the 
correct axception condition. ; 

PSR NVOED4S4 

PSR NV0D424 


If a FAP returns abnormai status to AMPSOPEN during an OPEN (new)s 
the fille name ts still registered within the job and implicitty 
created permanent files are not purged. Recommend explicitly | 
purging the permanent file. | 
PSR NVOE1L50 


COPY_FILE does not work on index sequential files when executed 


from a tasks 


PSR NVOES83 


File attributes that can be changed cannot be reassigned a NIL 
value. : 
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10. 


li. 


12. 


13. 


14. 


15. 


16. 


17+ 


PSR NVEAOD3 


DETACH FILE returns FATAL abnormal status when a fite is not known 
and causes a batch job to terminate. Use of the STATUS parameter 
to ignore the error Is recommended. 

PSR NVOD618 


The SETLFILE_ATTRIBUTE command fer an existing file accepts the 
spacification of a preserved attribute even if it conflicts with 
the present one. No error will be seen and the preserved 
attribute will not be changed. 

PSR NVOC839 

PSR NVOD617 

PSR NVOD549 

PSR NV0D536 

PSR NVEAOD35 


When processing a COBOL READ REVERSE statements BAMN falls to set 
the fiie position to BOI and as a resuit the COBOL statement will 
loop indefinitely. 

PSR NVOE0D44 


COPY_FILE does not detect a copy to itself via circular file 
connections. 
PSR NVOE286 


Amp$put partials with term_option = ancS$terminates at 
file position BOI» gives *unrecovered write error! on anew file. 
Recommend using amp$put partials with term option = amc$start. 

PSR NVOD665 


Files implicitly attached are not implicitity detached 
PSR NVOE32Z2. . 
PSR NVOE296. : 


The CONTAINS_DATA fiag deitivered by AMPSGETLFILE_LATTRIBUTES is 
incorrect for a newly created index sequential file. This 
prevents AAM from working properly when multiple simultaneous 
QOPENs are issued on a *Ffile@s The work around Is to CLOSE and 
re~OPEN the file immediately after doing the first OPEN/NEW. 

PSR NVOEIOL 


An intermittant range error occurs If BAMSSYS_8LK_ VARIABLE REC. FAP 
during a COPY_FILE command. 
PSR NVOD706. 


Attributes in the NOS/VE fite label cannot be altered after 
creation. This could affect some migrating applications using 
indexed saquentialt filles because FILE_LIMIT could be updated on 
C176 but not on C180. 
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PSR NVEA034 


18. The fite position specifier on a MERGE directive in the SORT MERGE 
directive file isn't ignored. 
PSR NVOE4S15 

19. In the DISPLAY_FILE_ATTRIBUTE printouts OPEN_POSITION» 
MESSAGE CONTROL» and ERRORLLIMIT do not reflect the values 
suppiled by a previous AMPSFILE call. 
PSR NVOE515 

20. The attribute array given to AMPSFETCH_ ACCESS INFORMATION will not 
currently allow AMCENULL_ATTRIBUTE. 
PSR NVOE716 

7? LOADER 

1. If a task adds a library to the job's object tibrary list dynamic 
loads within that task willl be unable to satisfy externais from 
the newly added tibrary. This especialiy affects the usability of 
commands packaged in the job nonitor task because tibraries added 
to the object library ltist by the system prolog cannot be used to 
satisfy externais of these commands. 

PSR NVOE175. 

2 The default for the program attribute LOAD _MAP_OPTION is set to 
NONE. This maans a Joad map wiii not be generated by EXECUTE TASK 
uniess the LOAD MAP_LOPTION parameter has been previously specified 
by a SETLPROGRAM_ ATTRIBUTE command or explicitly specified on the 
EXECUTE_TASK command. 

3e The fength of targe data segments and files cannot exceed 
100s 000,00) bytes. a 

4. A job which attempts to use COPYLFILE on an Indexed sequential 


file witl. abort with an. error "unable to find FAP 
AHPSADVANCED_ACCESS_METHOOS*®,. 
PSR NVOC941 


4.8 INIERACIIVE 


le 


If a user's terminal shoutd become disconnected from NOS/VEs the 
job can be resumed by logging In to the system and entering the 
command ATTACH .J03 (ATTJ). The terminal will be reconnected to 
the jobs, and the job will be put Into a pause break state. The 
TERMINATE_COMMAND and RESUME_COMMAND commands can be used at this 
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time with the same results as during a pause break. A DETACH_JOB 
{DETJ) command has also been added to allow a user to detach a job 
by command. The DNISPLAY_JIOB_STATUS command will display 
disconnected and detached jobs. Detached jobs will be terminated 
after a system defined time has elapsed. 


2. In order to use a CDC 721 terminal on NOS/VEs the following 
command should be entered: | | 


SET_TERMINAL_ATTRIBUTES TC=T4010 


3. Access to NOS/VE (VEZIAF) vie X25 connection will cause the 
terminal Cand Its NOS/VE job) to hang. The hang state can be 
cleared by antering any TIP commands such as escape-CH. Code to 
fix the problem in CCP is availabie and is associated with PSR 
number CC5A230. 


4, NOS/VE R1.9.2 does not support an END<OF<INFORMATION (EOI) 
facility for indicating to an Interactive program that the user 
wishes to terminate interactive input of deta. The Input must be 
ended by a count or by detection of a particular input value. 

PSR NVOE4S4 


5. If an interactive job is using a display type terminal (CRT) and 
the page width terminal attribute Is not set to exactiy the page 
width of the terminals then overprinting of some tines wiil occur. 
To remedy this either set the page width correct!y for the 
particular terminal or set the output _device attribute to printer. 


4.9 JOB MANAGEMENT 
If the job reaches time limits the WHEN clause is repeatediy 
activated with normal status. If the when contains a CONTINUEs = then 


processing continues in an endiess loop. 
PSR NVOE368 


4010 INTERSTATE COMMUNICATION 


Changing passwords on NOS and NOS/VE 


For NOS 2e2s9 your NOS batch password has to match your NOS/VE 
password otherwise Interstate Communications will not work since it 
gubmits batch Jobs to NOS. Refer to Section 4.3 of the SRB on how to 
change your passwords. | 
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411 DISPLAY BINARY_LOG 
411.1 DISPLAY BINARY_LOG 


DISPLAY BINARY LOG is a command utitity that processes the contents 
of the global binary fogs ( statistics» accounting and engineering) into 
human readable reports and graphse There are no pre-packaged reports 
bullt into DISPLAY _BINARY_LOG; insteads user sub-commands specify the 
statistics to be axtracted from the log and the types of analysis to be 
performed. Input to the program may be either an active system log» or 
a permanent file copy of a log as produced by the Terminate_Log command. 
The Information to be extracted from the logs», and the type and format of 
the reports produceds is specified by sub-commands supplied by the user. 


4.11.1.1 [he DISPLAY BINARY LOS Command 


PDT disblcpdt ({ 
inputs §: LIST OF FILE 
types t3 KEY statistics statisticss accountsee. 
accountings engineering = statistic 
outputs o: FILE = $OUTPUT 
status ) 


This commands which may be abbrieviated OISBLs enters the user into 
the command utility environment. Subsequent sub<—commands will be 
prompted for by the string "DISBL/*, 


The binary tog to be processed may be either a currently~-active 
system logs, or a copy of a terminated log. If an active tog is to be 
useds the TYPE parameter specifies the desired system global logs and 
the INPUT parameter is omitted. If -a terminated log is to be used» the 
INPUT parameter specifies the file names and the TYPE parameter is 
omitted, If a list of file names Is provided for the INPUT parameter» 
the data will be processed as if the contents of these files are 
concatenated in the order that the files are specified. 


The OUTPUT parameter specifies the file on which the reports 
generated by DISPLAY _BINARY_LOG are written. Ali current reports are 
formatted for a page width of 132 columns. 


The first output page generated by DISPLAY _ BINARY_LOG Jists the input 


files processed and the beginning and ending dates and times for each 
file. 
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4.11.1.2 Nefinition Sub-Cosmanods 


The user extracts data from the binary iog by first specifying one or 
more groups of statistics» and then specifying one or more metrics 
(numbers expressing a measurement) to be derived from each group. For 
examples one group might consist of the end<-of-job statistic for each 
job run on the systems and an associated metric might be the CP time 
consumed for each job.. | 


Final reports are generated through the use of a set of DISPLAY sub- 
commandse The particular DISPLAY sub-command used specifies the form of 
the report (histograms statistice!l summarys etcse)»s and parameters to the 
sub- command specify the metric or metrics to be displayeds and 
additional information about the form of the report. 


To economize on execution times DISPLAY _BINARY_LOG processes all sub- 
commandss up to the QUIT sub-commands before generating any reports. 
The binary log need be scanned only onces and all reports are generated 
in parallel. They appear on the final output files howevers in the 
order in which their sub-commands were issued. ; 


As each group and matric is defineds it is given a user-chosen names 
which Is subsequently used to refer to it. These names may be up to 31 
characters in tengths and follow the usual SCL conventions for names. 
The group or metric Identifled by a given name need not be defined 
bafore the name is useds but must be defined before the QUIT sub-command 
that terminates the sub-command sete 


4.11.1.201 THE DEFINE_GROUP SUB<COMMAND 


POT defg pdt ( 
groupsg: NAME = $REQUIRED 
statistics s3 NAME 
time, ts: RANGE OF time value 
date»s d?: RANGE OF date _vatue 
Job predecessors jp: NAME 
task_predecessor, tp: NAME 
descriptive datas» dd: STRING 
between, b: LIST 2 OF NAME 

) 


This sub-command defines a statistic group. The GROUP parameter 
supplies «a name for this groups and is required. The othar parameters 
are all optional, and specify conditions which each statistic must 
satisfy before it will be part of the group. If two or more conditions 
are specified, a statistic must satisfy all conditions specified before 
it will be Included In the group. 
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The STATISTIC parameter specifies a statistic identifier. Statistic 
identifiers are of the form AANNNNNs where AA is two alphabetic 
characterss and NNNNN fs a decimal number, For examples AV260GC7 Is a 
statistic amitted by the accounting and validation code at and-of-job. 


The TIME and DATE parameters can be used to limit the time period 
within which statistics will be recognized. The default range of time 
Is from 00:00:00 to 23359259. The default range of date is from 
C0/01/01 to 12/31/99. If only one value is specified for a parameter» 
instead of a ranges then the provided vatue will be taken as the tower 
limit of the ranges and the default used for the upper timit. 


The DESCRIPTIVE_DATA parameter supplies a string which Is matched 
against the contents of the descriptive data field in each statistic. 
Matching Is performed character~by-character to the end of the parameter 
stringe If the descriptive data field In the statistic is longer than 
the parameter strings the excess characters are ignored. 


The TASK PREDECESSOR parameter Is used In combination with other 
parameters on the DEFINE _GROUP sub-command to relate two or more 
statistics Issued by the same taske The TASK PREDECESSOR condition is 
satisfied if the task issuing the statistic also previously issued 
another statistics which is a member of the group specified for the 
TASK PREDECESSOR parameter. 


For example: 


Define group compile tasks statistic = PM230002»5 .. 
descriptive data = "FCPSCOMPILE FORTRAN_SOURCE!® 

Define_group compile _endlof_task statistic = PM230003»5 .. 
task predecessor = compile tasks ¢208:300:00..16:00100» o- 
d#01/01/83..01/01/83 


These commands define a group calied compile_end_of_ task that contains 
the end of task statistics for all FORTRAN compliation tasks. 


The JOB. PREDECESSOR parameter Its used In combination with other 
parameters on the DEFINE_GROUP sub-command to relate two or more 
statistics issued by the same job. The JOBLPREDECESSOR condition is 
satisfied if the job Issuing the statistic also previousiy issued 
another statistics which Is a member of the group specified for the 
JOBLPREDECESSOR parameter. 


The BETWEEN parameter Is a futurs feature. It is currentiy accepted, 
but ignored. 


ellele2e2 DEFINE_METRIC SUB-COMMAND 


- COMPANY PRIVATE - 


4-16 
SOFTWARE RELEASE BULLETIN 
| 84/03/12 
NOS/VE (CYCLE 18) 
4.0 OPERATING SYSTEM NOTES AND CAUTIONS 


POT defm_pdt { 
metrics m: NAME = $REQUIRED 
groups gi NAME = $REQUIRED 
scale factors sf: INTEGER 
units ut STRING 
counters ct INTEGER 1..63 
expressions ea: STRING 

) 


This sub-command defines a metric. The METRIC parameter specifies a 
name for this metrics and Is required. The GROUP parameter is also 
requireds and specifies the group from whose members this metric is to 
be derived. 


The SCALE_FACTOR parameter is used to adjust the values of the 
resulting metric in order to make therm easter to understand or use. 
Each metric element ts divided by SCALE_FACTOR before being used to 
generate reports. IF this parameter is not specifiad on the 
DEFINE METRIC sub—commands, a value of 1 is used for the scale factor. 


UNIT is an optional parameter that can be used to provide a string 
identifying the measurement unit associated with the vaiues of this. 
metric. If aounit Is supptileds tt is used to tabelf that metric in all 
output reports. If the UNIT parameter is not useds it defaults to 
blanks. 


The other parameters specify different ways in which a metric can be 
derived from the members of the group. QDne and only one of these 
parameters can be used in a given DEFINE METRIC sub-command. 


COUNTER specifies the index of one of the 63 posstblie counters 
Included in a statistic. The contents of the specified counter for each 
statistic In the group make up the resuiting metric. 


EXPRESSION specifies an arithmetic expression that is evaluated to 
yield the value of each metric element. At presents the only expression 
that is accepted by DISPLAY_BINARY_LOG Is '1*. This expression Is used 
to count the number of atlemants in a metrice — 


4o11.1.3 Display sub=Commands 


This group of commands Is used to specify reports to be written to 
the output file. As noted aboves all commands are processads up to the 
QUIT commands before any reports are actually generated. The reports 
appear on the final output file in the order in which their sub-commands 
were Issued. 


~ COMPANY PRIVATE - 


4-17 
SOFTWARE RELEASE BULLETIN 
84/03/12 
NOS/VE (CYCLE 18) 
4.0 DPERATING SYSTEM NOTES AND CAUTIONS 
4elle1230e1 DISPLAY_SUMMARY SUB-COMMAND 


4.11.1.301 DISPLAY_SUMMARY SUB-COMMAND 


PDT diss pdt { 
metrics mt NAME = $REQUIRED 
tities, t: STRING 
>. 


This sub-command requests a statistical summary report. This report 
includes such Information as the means maximum and minimums and total 
number of elements of the specified metric. 


The METRIC parameter specifies the metric to be reporteds and “is 
required. . 


The TITLE parameter may be used to provide a titie to be placed at 
the top of the report page» If omitteds the metric name is used, 


Gellele3e2 DISPLAY_DISTRIBUTION SUB-COMMAND 


PDT disd { 

metrics mi NAME = $REQUIRED 

titles, t : STRING : 

Fimitss timits @: (C Pls 12 ds € 135 14 ))2 INTEGER 

dispiay_options do: KEY max min bounds first max centered» 

second max centered = max min bound 

x_intervals xi: KEY self_adjusts» large, mediums small = 
self adjust 

) 


This sub—command requests a distribution plots which indicates the 
number of metric elements with each value within the observed range. 
The report consists of a frame indicating xX and Y axisess with the 
possibile vaiues of the metric on the X axis» and the element count on 
the ¥Y axis. OISPLAY_BINARY_LOG places asterisks within the frame to 
Indicate how many metric ealements had a particular value. The report 
aiso displays the number of elements within the frame and the number of 
elements which exceed the frame limits . 


The functions of the METRIC end TITLE parameters are the same as in 
the DISPLAY SUMMARY sub—command. 


The LIMITS parameter can be used to define the frame boundaries. The 
defaults on the X-axis are the minimum and maximum of the contents in 
the counters On the Y-axis» the defaults are the minimum and maximum 
number of elements among X= axis intervals. First value set defines the 
X¥ boundaries. Second set defines the Y boundarles. First value In each 
set defines tha flower boundary. ‘'-1' can be used to specify a defauit 
boundar ye 
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EXAMPLES: 
t=(( 505 1000 )) X Jower bound = 50.9 upper bound = 1606 
Y boundartles are default. 


¥=(( -1, 1000 )» X lower bound = defauits upper bound = 1600 
{( 109 -1 )) Y dower bound = 10») upper bound = default 


The DISPLAY_OPTION parameter can be used to select first maximum = or 
second maximum ( on Y-axis ) portion of the graph. FIRSTUMAX_CENTEREDs 
SECOND MAX _CENTERED and MAX_MINIBOUND are the keywords. The defauit of 
this parameter Is MAX MIN BOUND. 


The XUINTERVAL parameter can be used to determine the number of 
intervals into which the X-asis of the frame is divided. 3 different 
sizes are avallable: 


LARGE =~ X-axis is divided into 11 intervals}; 
MEDIUM — X—=axis Is divided Into 21 intervals; 
SMALL - X-axis Is divided into 101 Intervais. 


The defauit of this parameter is SELF_ADJUST. When default is used» 
the X— axis division will be depend on the X-axis timits atone. The 
rules are: 


 X upper_bound — X_tower_bound <= 19 11 intervals 

X_upper bound —- X tlower_bound <2 500 21 intervats 

X_upper_ bound =— X_fower bound > 500 161 intervals 
NOTES: 


1. The first and the last Intervals on the X axis are one-half the 
width of the other X axis intervals. 


2. The X—axis upper limit as displayed may be stightiy higher than 
the value specified In the subcommand. The rules are? 


11 intervals {( X upper - X_Jower ) modulus 10 = OG 
21 intervals ( XLupper - X_lower ) modulus 20 = 0 


101 intervals ( X upper ~- X lower ) modulus 100 = 6 


Gellelse303 DISPLAY_TIME_DISTRIBUTION SU3-COMMAND 
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POT distd_pdt( 
metrics mt NAME = $REQUIRED 
metric_llimitss mi: LIST 2..2 of INTEGER = $REQUIRED 
titles t: STRING 
) 


This subcommand generates a graph which pilots metric vaiues against 
time. The X-axis represents the time intervals and the Y-axis 
“represents the element counts of the metric. The asterisks placed 
within each time interval represent the range of element values seen In 
that interval. The report aiso generates the number of elements within 
the frame and the number of elements which exceed the frame limits. 


The METRIC parameter specifies the metric name to be reported. 


The METRIC_LLIMITS parameter specifies the limits to be used for the 
Y-axis. The limits for the X-axis will come from the date and time 
parameters given on the DEFINE_GROUP subcommand. 


eaxample: mi2(Q»5C0) Y flower bound = 0 
Y upper bound = 500 


The TITLE parameter is used to provide a title to be placed on the 
top of the report page. If omitted, the metric name will be used. 


4o11.1.364 DISPLAY_DESCRIPTIVE_DATA SUB-COMMAND 


PDT disdd_pdt ( 
groups g: NAME = $REQUIRED 
tities t: STRING 
) 


This sub command processsas the members of a groups rather than a 
metric. It displays values (up to 256 characters tong) for the 
dascriptive data field of each statistic In the group, together with the 
number of times each value was encountered. 

The GROUP paramater specifies the group to be scanneds and is required. 

The TITLE parameter may be used to specify a character string to be 


placed at the top of the first page of the report. If it is not 
inctuded in the sub-commands then the name of the group is used Instead. — 


4e1101.3-05 DUMP_GROUP SUB-COMMAND 
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POT dumg pdt { 
groups g? NAME = $REQUIRED 
counter formats, cf? LIST 1.635 1.22 range of INTEGER 1..63 
tities t: STRING 
) 


This sub—-command processes the members of a group rether than a 
metrice Each statistic within the specified group is listed in full. 
This group dump Is particularly useful for debugging group 
specifications and statistic definitions. 


The GROUP parameter specifies the group to be dumped», and is 
required. 


The COUNTER_FORMAT parameter specifies in what base the counters will 
be displayed. The default base Is 14. 


example: cf=((1..68210)9(9.226358) ) 
Counters 1-—- 8 wiil be disptayed tn base 16. 
Counters 9 — 63 will be displayed In base 8. 


The TITLE parameter may be used to specify a character string to be 
placed at the top of the first page of the dump. If it is not inciuded 
in the DUMP GROUP sub-command, the name of the group Is used Instead. 


4o1le1le4 GENERALE GROUP FILE Sub-Command 


PDT gengf_pdt ¢ 
groups gt: NAME = $REQUIRED 
outputs o: FILE = S9UTPUT 
parmanents p: BOOLEAN = FALSE 
) 


This sub_command selacts a group of statistics defined by sub command 
DEFINE. GROUP» and writes the statistics to a legibie file In a format 
suited for machine processing. 


The GROUP parameter specifies the group to be selecteds and is 
required. 


The DUTPUT parameter specifies the focal file name which contains the 
selected statistics. If it is not Included in the sub.commands the name 
$OUTPUT is used as the default file name. The attributes of the output 
file will be: he eh 
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FILE_LCONTENTS = LEGIBLE 
FILELORGANIZATION = SEQUENTIAL 
FILE_LPROCESSOR = UNKNOWN 
PAGE_FORMAT = CONTINUOUS 

PAGE WIDTH = 89 


{ Except for the flie $OUTPUT, where the default attributes of 
$OUTPUT are used. ) 


If the same file name Is used for OUTPUT parameter In several GENGF 
sub_commandss the order of the group statistics will be the same as the 
order of the GENGF sub _commands. 


The PERMANENT parameter its a boolean value» If PERMANENT = TRUE» 
then # permanent file with thea same neme specified in parameter CUTPUT 
will be created under the catalog SUSER. If the permanent file Is an 
existing files than a new cycle ( one higher ) will be created. The 
default value of this parameter Is FALSE. 


There are some restrictions when parameter PERMANENT = TRUE Is 
specified. 


1. Parameter OUTPUT can not. be the default vatue or $OUTPUT. The 
conflict of the file attributes will ceuse the sub_command to be 
rejected. 


2s Parameter OUTPUT can not be the same as In any previous GENERATE, 
GROUP_LFILE sub commands. The local file name conflict will cause 
the sub _command to be rejected. 


-3. Parameter OUTPUT can not be the same as an existing tocal file 
Name » The local file name conflict will cause the 
DISPLAY BINARY_LOG to be aborted. 


The PERMANENT parameter Is not consistent with NOS/VE phifoscphyys and 
may be removed in a future update. This wil! not deprive users of any 
functionality. 


Examples: 


CASE 1 ( Jtfegal useage ) 
defg g=open_input s=ev1900 
GENGF g=open_input PERMANENT=TRUE 


CASE 2 ( Jitlegal usage ) 
defg gzopen_Input s=ev1960 

dafg-g=ctose_input s=evl001 
GENGF gzopen_Input OUTPUT=INPUT_GROUP | 
GENGF geclosea_input OUTPUT=INPUT_GROUP PERMANENT=TRUE 
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CASE 3 ( tegitimate usage ) 
defg gzopen_input s=ev1900 
def 3 g=close_input s=ev1091 
GENGF geopen_input OUTPUT=INPUT GROUP PER MANENT#TRUE 
GENGF g=close_input OUTPUT=INPUT_ GROUP 


Each statistic is output as one or more text lines». The first tine 
contains the header informations including the number of counters and 
the size of the descriptive data string. The counters are output nexts 
occupying as many tines as necessarye The descriptive data string is 
cutput lasts ona single tine. The format of each statistic in the 
cutput file is shown below: 


Line from Che to Che. Contents 

1 2 3 statistic_identifier 

1 4 9 statistic code 

1 ii 17 julian date({ yyyyddd ) 

1 19 39 time{ hhimmtss.millisecond ) 
1 32 36 jJob_name 

L 38 45 global _task_id ¢€ nnnn-mmm ) 

1 47 48 condensing frequency 

1 70 71 number of_counters 

1 73 75 descriptive _data_size 

2 1 20 counter 1 ( right justified, 
2 2l 49 counter 2 biank filled ) 

2 41 60 counter 3 

2 61 BO counter 4 

3 1 29 counter 5 

: 2 3 2 

3 : 3 t 

n=] 3 ? 3 

n 2 89 descriptive data 


4e11.1.5 Ihe Quit SubsCommand 


This sub-command has no parameterse It ends acceptance of 
sub-commandss and begins processing of the prior sub-commands§ to 
generate reports. . 


4.11.2 THE ACTIVATE_STATISTICS COMMAND 


This command is used to establish and enable one or more statistics 
to a given global binary loge It may be abbreviated as "ACTS". The PDT 
is: . : 
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PDT acts command { 
statistics statisticss s: LIST OF NAME = $REQUIRED 
type, t: KEY statistics statistics, accountings accounts ees 
engineering = statistic . 
STATUS ) 


The STATISTIC parameter specifies one or w*more statistics to be 
established and enabied. Each statistic is specified as two aiphabetic 
characters followed by a decimal number; for examples AV260007. <A tist 
of statisticss enclosed in parenthesis as per SCL syntaxs may be 
specified. . 


The TYPE parameter specifies the global binary tog to which the 
specified statistics are to be enabled. Onty one iog may be specified 
In each ACTIVATE_STATISTIC command. If it is desired to send a 
particular statistic to more than one logs multipte ACTIVATE STATISTIC 
commands may be used. 


4011.3 THE DEACTIVATE_STATISTIC COMMAND 


This command is used to disable one or more statistics that had 
previously been enabfted to a particular tog. All statistics remain 
established, and If they are enabled to another togs that connection 
ramains undisturbed. The command name may be abbreviated as DEAS. 


PDT deas command ( ; 
statistics, statistics, st: LIST OF NAME = $REQUIRED 
types t: KEY statistics statistics, accountings accounts see 
engineering = statistic . 
STATUS ) 


The STATISTIC parameter specifies one or more statistics to be 
disabled. Each statistic Is specified as two alphabetic characters 
followed by a decimal number; for examples AV260007. A tist of 
statisticss enciosed in parenthesis as per SCL syntaxy» may be specified. 


The TYPE parameter specifies the global binary log to which the 
specified statistics ara to be disabled. Only one tog may be specified 
in each DEACTIVATE_STATISTIC command, If it is desired to disable a 
particular statistic from. more than one logs muitipie 
DEACTIVATE_STATISTIC commands may be used. 


Ail statistics specifiad in the DEACTIVATE_STATISTIC command must 


have previously been enabled to the specified togs either by an 
ACTIVATE_STATISTIC command or by a program Interface call. 
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4.11.4 ACTIVATE_LINTERVAL_STATISTIC 


The ACTIVATE_LINTERVAL_STATISTIC (ACTIS) command is used to establish 
and and enable those statistics which are emitted on an interyal basis 
to a given global binary toge This command can only be issued from the 
system console. 


POT actis_command ( 
Jims intervals ji: Integer 1..999 = 1 
pms_intervels, pit integer 1.2999 a 5 
status ) 


The STATISTIC parameter specifies the statistics to be emitted. The 
only valid statistics of this type currentiy is the 908210000 and 
08210001 statistics. 


The JMS_LINTERVAL parameter specifies at what time intervai the jms 
statistic (08210000) should be emitted. The default value is 1 minute. 


The PMS_INTERVAL parameter specifies at what time Interval the PMS 
statistic (08210001) should be emitted. The default value is 5 minutes. 
$21125_DEACTIVAIE_ INTERVAL STATISTIC 

The DEACTIVATE_LINTERVAL STATISTIC (DEAIS) commmand Is used to disable 
interval statistles that have previously been enabled to a particular. 
foge This command only disables the 082100060 and 08210001 statistics. 
This command can onty be issued from the system console. 

POT deals command ( 

status ) 


401105 STATISTICS AVAILABLE IN NOS/VE 


This. ts a list of the current statistics available on NOS/VE. 
STATISTIC NAME COUNTER/DESCRIPTIVE DATA 


AV260009 Accounting CP time Cl: Total CP increment 
| C2: Job-mode CP time incr. 
C3: Monitor-mode CP time incr. 
AV 260001 Accounting Page Faults Cl: Total page fault incr. 
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AV 260002 Accounting working set C1: Current W.S. size 
AV26000 3 Accounting Ready Tasks Cli: Current ready task count 
AV 260006 Accounting Begin Accnt. ND: 1-31 — account name 
32-33 - %, # 
34-64 - project name 
AV 260007 Accounting End Account C1: Total job SRU#s 
C23: Total job CP time 
AV 2600038 Accounting SRU' s Ciz Total SRU increment 
CL170009 Display message command 90: String specified in 
command 
€1L170001 Command names DD: Name of command; upper 
case,» 31 characters 
JM180009 User name ND: User name}; 31 characters 
JM180001 Job name DD: User's job name; 31 chars 
JM180002 Job mode OD: *INTERACTIVE® or *BATCH?3 
. 11 characters 
34180003 Job end Ci: CP time — job mode 
C2: CP time - monitor mode 
C3: Page fauits . 
C4: Page-ins 
C53 Page-reclaims 
C6: Page-assigns 
PM 230000 Task begin None | 
PM 230001 Task Starting Procedure DD: Starting procedure name; 
31 characters 
PM 230002 Task name DD: Task name; 31 characters 
PM 23000 3 Task end Ci: CP time — job mode 
C2: CP time —- monitor mode 
C3: Page faults 
C4: Page-ins 
C5: Page-reclaims 
C6: Pagem-assigns 
PM230004 Loader hegin 


none 
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PM 230005 Loader end C1: CP time ~— job mode 
C23 CP time — monitor mode 
C3: Page faults 
C4: Pege-ins 
C53: Page-reciaims 
Co: Page-assigns 


FC 580009 Fortran Complitation C1: Task time in compiler 
C2: Monitor time 
C32 Noe of lines compited 
C42 Noe of statements 
C53 Noe of program units 


FC 580001 Fortran Program Unit 0D: Program unit name 
| C1? Task time for unit 
C2: Monitor time for unit 
C3: Noe of tines in unit 
C4: Noe of statements 


(5210009 JMS—interval | C1: free pages 
(job-memory interval) C2: avaliable pages 
. C3: avallable modified pages 
C43 wired pages 
C5: shared pages 
Cot fixed pages 
C7: I0 error pages 
C83 job shered pages 
C9: job working set pages 
C10: swapped jobs 
Cil: reedy tasks 
C12: Interactive class 
C13: batch class 
C14: site class 6 
C15: site class 1 
C16: site class 2 
C17: site class 3 
C18: maintenance class 


0$210001 PmS—Interval Ci: pf avaliable 
(paging-monitor Interval) C2: pf avaitabte modified 
C3: pf disk read 
C43 pf new page 
C5: pf tocked 
C6: pf 10 reject 
C73: force aggresive aging 
C8: aggresive aging shared queue 
C9: aggresive aging job queue 
€10: aggresive aging failed 
C1is: write aged page 
Ci2: mr cycie 
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C13: mr cycle average duration 

C14: wr delay 

C15: mr delay average duration 

Cl6: mr walt : 

C17: mr wait average duration 

C18: mr write modified pages 

C19: mr write modified pages 
average duration 


4012 ACCOUNTINGZVALIDATION 


le 


2e 


The ADMINISTER_USER utility can be run from a batch Jjob or SCL 
procedure contrary to what the Family Administrator for NOS/VE 
Usage Manual says» 

PSRs NVEA045 and NVEA046 


Great care should be taken using the DELETELUSER subcommand. If 
more than 20 users ara deleted since installation of the system, 
there is a good chance all users will be lost. 

PSRs NVODO96» NVOEG61, NVOEOH2 
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5eO PRODUCT SET_NOTES. AND CAUTIONS 


Sel CYBIL 


1. 


2s 


4 


5 


6 


When using DEBUG to breakpoint on a multi-line statements the line 
number supplied to DEBUG must be the tast fine number of the 
statement. 

CILAS98 


Run-time error messages» such as RANGE ERROR» don't display the 
bad value. 
CILA575 


A large string variable is miscompiled with the wrong size. 
CILA774% 


CYBIL aborts with CGl error 101» 515 52,5 and 38 with no tistings. 
PSRs CILA7T27» CILA785, CILAT787» CILA679 


CYBIL aborts with “ring number zero”™,. 
PSR CILAT68 


CYBIL aborted without any diagnostics 
PSR CILA755— 


502 COBOL 


le 


20 


Je 


If a USE declarative Isn't presents then an I/0 error occurring 
during flie input or output causes the job to abort with CB 
569260. The text of that message reports “"I/0 errorese™s but it 
doesn't show the underlying reason (for examples “parity error™). 
Hences the user should be watchful to Include USE declarations for 
any file where full error messages are desired. 


The COBOL READ REVERSE statement does not work. If useds it wiil 
foop indefinitely on the first record and never take the AT END 
path. This Is the result of BAM failing to set the file position 
to BDI. . 

PSR NVOCEO44 


Two consecutive instances of OPEN QJUTPUT on the same indexed 
sequential file will not cause a message warning that the data has 
been evicted by the sacond OPEN. The user should refrain from 
issuing another OPEN OUTPUT once the flie has been created. 

PSR AABA1L06 
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5.3 ELLE_MANAGENENT UTILITY 


1. 


26 


36 


Do not use the file name INPUT In batch mode. It is always a nuil 
(ampty) file with no data in it. Choose a different name. This 
affects migration of Jobs from NOS» where the name INPUT wes the 
Job's input deck. On NOS/VE use the COLLECT_TEXT command to 
create the Input data. 


When using FMU and Inside Interstate Communication Facilitys do 
not do a CLEAR on the EXECUTELINTERSTATE COMMAND. This will clear 
FMU checkpoint files and render FMU inoperable. 


If the 180 Interstate Communication Facility job aborts, the 
corresponding 170 FMSLAVE job bacomes hung and does not return 
previously attached files. These FMSLAVE jobs remain at control 
points and continue to be CPU and memory overhead. Corrective 
action should Include for the user or operator to drop the “hung 
jJobs™. They can be Identified at a control point as 
WEMSLAVEsINITIAL™» "FMSLAVEsNORMAL"» or “FMSLAVE, ABNORM". 

PSR. NVYGE735 


5e4 EQRTRAN 


le 


Ze 


36 


4 


Se 


When using READ (* 2.22) $n batch Jobss a file containing the 
desired input must be connected to SINPUT by 
CREATE_FILE_CONNECTION or equated to INPUT on the FIN” program 
statement or LGO statement. | 


If INPUT or OUTPUT is opened using an OPEN statements, the OPEN 
statement must be changed to use SINPUT or $OUTPUT. 


To insure correct listings and improve compilation performances it 
Is necessary to prevent the listing file and the errors file from 
being the same file. In batch Jobs» both would default to 
SOUTPUT. To avoid thiss set the ERROR parameter on the FORTRAN 
command to a file reference diffeent from that of the LIST 
parameter. 


Utitity subprograms CALL CONNEC and CALL. DISCON do not work. 
Their use will cause your program to abort in execution. 
PSR FNSA9I090 


RUNTIME_CHECKS=NONE should be specified In addition to OPT#HIGH In 
the FORTRAN command options when the objectives is to achieve the 
fastest possible execution time for a FORTRAN program. The 
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compiler generates runtime checking code by default at aif OPT 
favelss» unlike FINS on the 170 which generates checking code only 
If explicitiy requested. Checking code can have aie considerabie 
impact on execution times since every array element reference with 
a variable subscript generates a cail to a tibrary routine. 
ONE_TRIP_DO=0N should also be selected to Improve execution time 
if all DO loops in the program have an iteration count of at feast 
one e 


When compiling at OPT=HIGHs the FORCEDUSAVE=0N option should be 
used for any subprogram which relies on the values of its tocal 
variables or arrays being saved between calis to the subprogram 
but does not use a SAVE statement to retain their definition 
status. At OPT=HIGH tocal variables and arrays which are not 
saved are normally allocated on the runtime stacks» so that their 
values are tost after the execution of a RETURN or END statement 
in the subprogram. At OPT=LOW/DEBUS focal varlabies and arrays 
are always allocated to a static memory segment so that saving is 
always in effects as it is on the 17 for non-overlayed FINS 
programs compiled at any OPT level. 


5o5 ADVANCED ACCESS METHODS 


A 


job using an Indexed seb dake file will fall due to entry point 


errors +r oR the ioader. 


The following commend executed aartier in the dob will correct this: 


SET_PROGRAM_LATTRIBUTES TERMINATION _ERROR_LEVEL#=FATAL 
or SETPA TEL=F 


PSR NVOE2ZT6 


5e6 SOURCE CODE UTILITY 


le 


20 


The SCU editor command SEARCH BACKWARD will hang if asked to 
locate multiple occurrences of a range of text. <A terminate break 
will stop the hung command and allow the user to continue editing. 
PSR SC8A027. 


An anomaly can occur when some modifications are excluded when a 
dack is expanded. An example is below: 
Line 1 version 1. 
is introduced by modification A. Modification 8 raplaces this 
line with . 
Line 1 varstion 2. 
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Then modification ¢€ in turn replaces this tine with 

Line 1 version 3. 
If one expands the deck with modification 8B excluded both the 
fines introduced by modifications A and C will appear In the 
COMPILE file... 


Se? PEQDUCT SET_=_ DEBUG 


le 


20 


When an unselected even occurs In a ring lower than the ring in 
which it is runnings DEBUG Incorrect!y Informs the user that the 
error occurred in the procedure which called the faulty procedure 
in the lower rings 


DEBUG and CYBIL do not have a run-time Interface. Therefores a 
program which aborts due to “"CYBIL run time error™ cannot be 
properly trapped by DEBUG. Instead» the DEBUG trap occurs In the 
CYBiL error processor; ali dynamic variables (at the point of 
actual error) have been freed by the time DEBUG gets control. 


5°8 ONLINE MANUALS 


le 
2e 


The HELP abbreviations HEL» is broken. 


On Line manuals wlll be documented In the NOS/VE Installation and 
Upgrade Reference Manual for Release 1lelele Untli that times the 
Installation process has been described earlier in this document 
In section 3212226 and the maintenance process will be described 
in this section. 


Installed Into the $SYSTEM_MANUALS subcataltog will) be the 
following: 


FORTRAN (Reference Manual) 

FORTRAN_T (Tutorial) 

SORT (Reference Manual) 

SORT_T (Tutoridal) 

MIGRATE {NOS to NOS/VE Migration) 

NOS/VE (Default Manual for EXPLAIN)» 

COBOL | (Reference Manual) 

CoBpoL_T (Tutor ial) 

OCM {Object Code Mgmt Reference Manual) 
SCL (System Command Language Reference Manual) 
$cu (Source Code Utility Reference Manual) 
CONTEXT (On Line Manual Author*s Guide) 
MESSAGES (NDS/VE Diagnostic Messages) 
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and a MAINTENANCE subcatalog which contains the SCU source library 
of ali the manuals and the binding procedure for creating new 
“bound™ manuals. 


The source is being distributed to allow customers the capability 
of taitoring the manuals for their site. Source !ibraries contain 
modifications reflecting the revision level documentation changes. 
This not only gives the benefit of a “revision packet™ to identify 
new features and changes, but also aids the update process for te 
site version of manuals. 


To tailor a manual for a site: 


a» Create r new source tlibrary or additional cycle of 
Ssysteme,manuais.maintenance.source_ library refiecting the 
modifications. (Note that each manual is contained In a 
deck. Decks are grouped by product.) 


b. Execute Ssystem.manualsemeintenancesbinding_ procedure within 
the $Ssystem user or maintenance user number to create new 
manuals. 


PROC bind manuals» binms bind manual 
manuals manuals» m: LIST OF NAME or KEY all = all 
bases, b: FILE = $SYSTEM.MANUALS «MAINTENANCE .SOURCE_ LIBRARY 
catalogs ci FILE = SUSER.MANUALS 
status) 


whereas. 
manual = secu deckname(s) of manuai(s) desired to be 
created 
base = source tibrary used for compilation 
catalog = resuitant catalog for new manual(s) 
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6.0 NOS_B2s2 


The BATCHIG printer driver does not correctly handie long tines (over 
135. characters). The extra characters are either droppeds overprinteds 
or cause the page to be spaced erraticaliy. 

NS2C121 
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ToC ECA_LEVELS 


The folowing tables show the microcode and controlware teveis that 
were used to validate the NOS/VE system on the specified hardware 
systems supported. These tables show the ftatest official FCA levels of 
the hardware and microcode and the necessary modifications (deviations) 
required to support the NOS/VE system. Tables 1s 25 39 and 4 correspond 
to the C€170-815» C€170-8255 €170-835» C170-845» and €170-855 systems» 
respectively. 
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Al.O DEVICE CHARACTERISTICS 


Alo1 DISK DEVICES 
Alelel PHYSICAL CHARACTERISTICS 


3844-4%x B85-1x 


Spindtes/Cabinet. 1 2 
Cytinders/Spindle +823 843 
Tracks/Cylinder 19 40 
Sectors/Track 24% 32 
Bytes (8 bit) /Sector 483 516 


Aleles2 LOGICAL CHARACTERISTICS 


Ale1s2e1 Terminology 


Allocation unit - The quantum of assignment of mass storage space 
to a file. An allocation unit {ts a power-of—-two multiple of 
consecutive DAUs. At presents the allocetionvunit is not 
selectable ona file by file basis; all end-user files default to 
16384 byte allocations 


Device _allocation unit (DAU) - The quantum of allocation of a mass 
storage volume (spindie). NOS/VE views a device as an array of 
DAUs which individually or as a contiguous group (called an 
allocation_unit) may be assigned to a mass storage file. <A DAU 
consists of an integral number of MAUs; the ratio is device 
dapendent and dependent upon the granularity of allocation NOS/VE 
can afford to provide for a particular device. A DAU may = span 
tracks but never spans cylinders of a device. 


Large_sector - A controlware capability provided by the 7155 class 
of mass storage controtier which logicaily groups four physical 
sectors into one for the purpose of dacreasing device driver 
overhead. The term "MAU! Is preferable to ‘targe sector since 
not all controlilers may provide this capability to NOS/VE. Note 
that a large sector on an 885 device is composed of four physical 
sactors each of which contains 516 bytes. The last 33 of these 
bytes are not transferred when a physical sector is read in small 
sector mode» Therefores it is possthble that NOS/VE will encounter 
additional bad=<spots on a device previously only accessed in smail 
sector mode. The DLS diagnostic Is provided to verify the data 
fieid of a large sector. The controlware and NOS/VE consistently 
report fallure status In terms of physical (small) sector address. 


The iarge sector diagnostics such as DLS and FLDs howevers display 
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large sector address. When using the latter diagnosticss it is 
racommended that one rely on the sector address In the detalled 
status. 


« Minimumladdressable_unit (MAU) - The quantum of data transfer 
supported by a PP driver. The MAU Is a software concept which is 
used to normalize the various device sector sizes for the Central 
Processor. When the CP prepares requests for mass storage devices 
it thinks in terms of a number of MAUS. The PP driver then breaks 
down the MAU Into physical address and sectoring considerations. 
If amass storage device has a sector size which ts not a power of 
two bytes in length (such as the 844—4x)» then the MAU will begin 
at the start of a sector and finish In the midst of the tast 
sector; the number of sectors spanned is device dependent. An MAU 
may span tracks but never spans cylinders of a device. 


« Page size - A power of two number of bytes ranging from 512 bytes 
to 65536 bytes. NOS/VE Is presantiy constrained to supporting 
page sizes of 2043» 4096, 8192 and 16384 bytes. The constraint is 
a file system constraint related to adnot wanting more than one 
page per MAU and b) not wanting a page to span tracks. 


Ale1l.2.2 NOSZVE_Disk Volume Allocation 
B44—4yx B85-1x 


Sectors/MAU. 5 4 
MAU/Track 4.8 8 
DAU/Tr ack. 204 4 
DAU/Cyl Inder 44 160 
DAU/Spindie 37035 134880 
Bytes /MAU 2048 2048 
Bytes/Track Cav 9.) 948544 16384 
Bytes/Cylinder 180224 655360 
10**6 Bytes/Spindle 151.6 552446 


10**46 Bytes/Segment 2147.5 2147.5 


Alw1le2.3 NOS/AVE_Elie_ Allocation 
Altocation Unit Size: 844—4x 885-1*x 


(Consecutive DAUs). (bytes) (bytes) 
1 4096 4696 
2 8192 8192 
4 16384 16384 
8 32768 32768 
16 65536 65536 
32 131972 131072 
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6% 180224 262144 
128 180224 524288 
256 180224 655360 


Ale2 TAPE DEVICES 
Ale2el PHYSICAL CHARACTERISTICS 
Ale2e2 LOGICAL CHARACTERISTICS 
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A200 MASS STORAGE VOLUME MANAGEMENT 


A2.0 HASS_STORAGE VOLUME MANAGEMENT 


AZel SYSTEM INSTALLATION. PREPARATION 
A2Ze1s1 PREPARING 844 AND 885 DEVICES 


All 844 and 835 volumes are formatted at the factorye Neither 844 
nor 885 volumes need to be reformatted to be used by NOS/VE. Volumes 
used by NOS are Interchangeable with NOS/VE without re-formatting. 
Utility Map processing Is identical In all aspects.» Howevers with the 
exception of the Factory Map and the Utility Maps the data recorded on a 
volume by NOS cannot be Interchanged with NOS/VE and vice versa. 


NOS/VE does not honor the CTI deadstart sector content. Therefore it 
does no good to instali CTI or CML on a NOS/VE device nor can one expect 
this information to remain Intact across mixed system use of the devices 
Qege first NOS» then NOS/VE and then NOS again. CTI and CML should 
oniy be Instailed on the NOS deadstart device or an aiternate device 
used only by NOS. 


Prior to attempting NOS/VE system Installations tha following 
procedures should be performed either on-line using MALET on NOS or 
off-iine using DEMOT.. The objective of these procedures is to ensure 
the correctness of the Utility Map maintained on each device. The 
INITIALIZE MS_ VOLUME process described later uses the Utility Map to 
evold defects {bad-spots) on the disk surface. 


A2e1.1.1 System Deadstart Device 


ae For the NOS/VE system deadstart device it is recommended that the 
SCAN DISPLAY FLAWS module of the FMU diagnostic he used to displisy 
afl the sectors which have trask or sector flaws sete This 
display must then be compared to the display of the Utility Map. 
Any fiawed sectors not in the Utility Map must be added to ensure 
that the installation of the NOS/VE system will go smoothiy. This 
procedure should he expected to take at feast 10 minutes. Refer 
to the discussion of defect management below for further Insight 
as to why the above procedure is recommended. | 

b. Use the DL8 diagnostic to write/read large sectors on Cylinder 0» 
Track © of an 885 deadstart device. This accomplishes two things? . 
1) it proves that track 0 can later be written by 
INITIALIZE_MS_VOLUME CINIMV) 2) Ft ensures that fictitious 
unrecovered checksum fallures are not encountered by INIMV when 
performing NOS/VE tabel searching. Note that it is totally 
unnecessary to write large sectors on the whoie device because 
NOS/VE never reads a sector that it has not first written (except 
during INIMV label searching). 
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A2ele1l-2 Volumes Other Than the. System Deadstart Device 


The above procedure Is strongly recommended for each mass storage 
device to be used by NOS/VE. : 


A2e2 INITIALIZE _MS_ VOLUME 
A2e2el INITIALIZATION OF 844 AND 885 VOLUMES 


The INITIALIZE_-MS_ VOLUME (INIMV) subcommand of the Logical. 
Configuration Utility (LCV) Is used during the NOS/VE Installation 
process to prepare mass storage volumes for use by NOS/VE- The 
initiallzation includes writing a NOS/VE software label on the volume 
and processing the Utllity Map located on the volume itseif. Before 
proceeding with the Initialization of the volumes INIMV attempts to read 
a NOS/VE ftabel from one of three possible focations on the volume: MAUs 
Il» 2 and 3 are tried in succasstione. This is done as aie protection 
against operator error which could destroy files on the volume if 
re-iInitialized,. 


If an 885 volume has not been previously Initiealized by NOS/VE or hes 
not been written in large sector mode by diagnostic softwares then an 
uncorrected checkword failure will be reported for each of the three 
attempts made by INIMV to read a NOS/VE label. Under the previousty 
stated conditionss the reporting of these 3 failures is axpected and 
should oot be a source of concern. The 3 locations raad by INIMVs in 
the order attempted» are: 

1.Cylinder Os Track 0» Sector 6 

2eCylinder 9s Track 9» Sector 4 | 

3-Cyltinder O» Track 0» Sactor 8 (10 octal) 


Note that for an 844 devices, checkword fallures are pot expected 
during INIMV ftabel checking. 


Once convinced that It is not destroying files by mistakes INIMV 
proceeds to write a NOS/VE ltabel on the volume. Next It processes the 
Utitity Map recorded on the volume. The location of the Utility Map is 
device dependent as is the content of the map. However the manner in 
which the Utility Map is read by the: NOS/VE driver is device independent 
as follows: 


The 844 and 885 Utility Maps are written In smali sector format by 
the factory and by diagnostic utilities. The Utility Maps fail 
somewhere within a NOS/VE MAU (logical sector of 2048 bytes). The 
driver is given an MAU ordinal by INIMV and the driver attempts to 
deliver an MAU. This Involves reading either 4 or 5 smalt' sectors 
depending upon the device. Because some of the sectors have been 
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write-protected by the controller and some have not the driver attempts 
to read each small sector using the following sequence of commands? 


1eRead protected sector (34) 

2eRead (4) 

3e-Read factory data (30) 

Read utility map (37) 
If an address error is raturned for a particular sector the next read 
function is tried for the same sector until all 4 generic read functions 
have been tried or the read is successfuls whichever occurs firste 
Intervening address error failures are not reporteds only the tast of 
the four. <Any failure other than an address error detected after any of 
the four generic reads causes request termination and is reported. 


A2e2Zelel 9844 ULL LI ty Map Processing 


The INTIALIZE_MS VOLUME subcommand uses the Utility Map tocated at 
Cylinder 822» Track O» Sector 2 to flaw defects which have been detected 
at the factory or by the CE and recorded in the Utility Map. 


The Utifity Map is an array of 0 .. 161 fiaw entries. Each entry 
documents either a track fiaw or a sector flawe Sector flaws are 
recorded in the physical (small) sector numbering scheme. 


INIMV fogically flaws the DAU affected by a sector flaw and the 3 
DAUs affected by a track fiaw. Note that because of the data mapping of 
the 844 device a track flaw will also togically fiaw from 0 to 4 small 
sectors on the next track. 


To support diagnostic use of the devices INIMV also flaws cylinders 
820 «2 822-6 


A2e2el-2 B85. ULiLity Mao. Processing 

The INITIALIZE_MS VOLUME subcommand uses the Utltity Map tocated = et 
Cylinder 841» Track 1s Sector 1 to flaw defects which have been recorded 
there by the factory or by a CE. 


The Utility Map is an array of ° ee 161 Fiaw entries. Each entry 
documents a track flaw. : 


INIMV logically flaws the 4 DAUs which ere affected by a flawed 
tracke. , 


To support diagnostic use of the devices INIMV flaws cylinders 
84142842. | 
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A203 VOLUME _DEEECT MANAGEMENT 
A2e3el RECOMMENDATIONS FOR 844 AND 8858 DEVICES 


Once NOS/VE has been Installed and atl of its mass storage volumes 
have heen initializeds it is possible that additional defects will 
appear on the surface of a volume. 


The symptom of this defect Is tikely to Initially be a recovered 
read/write failure. If the same sector Is reported repeatediys cone may 
wish to take action to avold the toss of performance incurred by 
repeated disk driver recovery attempts. The SAVE DATA and RESTGRE DATA 
capabilities of the FMU diagnostic utility may be used to relocate the 
failing sector. This capability onty appiles to 885 devices as these 
devices provide two spare sactors per track for this purpose. The 
procedure must. be performed off-line to NOS/VE. Refer to the discussion 
of off-line flawing for further information. 


If the symptom of the defect is an unrecovered read failures the 
recommended procedure Is to defete the file to which the falling sector 
was allocated. The deletion of the file should only be done after 
repeated attempts to read the file have all falifted. It Is possibie that 
an unrecovered read fallure may actuaily be caused by an intermittent 
problem with the mass storage controller or storage device logic. 
Therefores repeated read attempts may eventually succeed depending on 
the cause and duration of the problem. If the file is deleteds NOS/VE 
wlll ensure that the failing DAU Is not allocated to another file. 
Refer to the on-line flawing discussion for further Informetion. 


If the symptom of the defect Is an unrecovered write failures the 
recommended procedure is to make a copy of the file. NOS/VE keeps 
unwritable modified pages of a file in memory until the file is detached 
by all jobs which may be sharing the flle. Therefore It Is possible to 
make a copy of the fille without re-encountering the original defect. 
Once a copy of the file has been mades deteate the ortginal file and 
NOS/VE will ensure that the falling DAU is not allocated to another 
file. 

If an unrecovered read/write fallure occurs on a file which Is 
critical to continued NOS/VE systam executions the only recourse is to 
take NOS/VE off-line» flaw the sector or the tracks re~initiatize the 
volume on which the flaw was set and perform an installation deadstart. 
It will be necessary to restore all permanent files. 


A2.4 ONLINE ELAWING 


Once a volume has been initialized using the INITIALIZE_MS_VOLUME 
~ COMPANY PRIVATE - 


A2=-5 
SOFTWARE RELEASE BULLETIN 
84/03/12 
NOS/JVE (CYCLE 18) 
NOS/VE Peripheral Maintenance and Support 
A220 MASS STORAGE VOLUME MANAGEMENT 
A204 ONLINE FLAWING 


subcommands NOS/VE pays no further attention to the Utility Map on the 
volumes, untess of course the volume should again be subject to 
initialization.. 


NOS/VE does not update the Utit ity Map under any circumstance. Oniy 
the diagnostic utilitys FMUs is used for this purpose. Refer to the 
discussion of off—tine flawing below. 


A2e%e1 NOS/VE SOFTWARE FLAWING OF UNRECOVERED MEDIA FAILURES 


NOS/VE dynamically fiaws defects detected on falling read or write 
operations, Defects are logically flawed In the software allocation 
tables stored on the Individual devices; this is referred to as 
software-flawing. 


When a DAU Is software-flawed the file to which the DAU Is assigned 
can continue to be accessed. If the cause of the defect is an 
intermittent problem subsequent reads of the DAU may not re-encounter 
the failure. Therafores NOS/VE's phitosophy is to not set sector or 
track flaws in the Utitity Map for unrecovered media failures. Howevers 
if the read faiture persists and the file is tater deleted from the 
system the bad DAU will not be re-assigned to another file. The same is 
true for DAUs which are the aa of falling writes except the write Is 
not re-attempted.. 


A205 QEE-LINE_ELAWING 


Oniy aoemaintenance person (CE) should perform physical flewing. It 
Is not recommended to set either a track or sector flaw on an 844 device 
or a track fiaw on an 885 device unless the defect prevents continued 
NOS/VE system execution. Setting such flaws on a device used by NOS/VE 
wiil destroy data recordad In the sector or track. If the defect Is not 
critical to NOS/VE system execution then on-line flawing is sufficient. 
Refer to the discussion of defect management above. ; 


If a particular sector Is causing system performance degradation dua 
to repeated successful fallure recoverys one may decide to relocete the 
data; this is an option only on an B85 device. 


Each track on an 885 device has two spare sectors. The Utility Map 
on the device has a defective sector list. If there are aitready two 
defective sectors reported for the affected tracks» no data relocation is 
possibia. If there is a spare sectors, the FMU diagnostic utility may be 
used to relocate the data in the falling sector to the spare sector. 
The 7155 controiware automatically skips defective sectors during a read 
or write. The FMU diagnostic utility provides modules to SAVE DATA» 
FLAW SECTOR and RESTORE DATA. The SAVE DATA writes the track with the 
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suspicious sector to a maintenance track. Next the FLAW SECTOR module 
is used to set a sector flaw. In addition to flawing the suspicious 
sectors FLAW SECTOR automaticalty rewrites the address fleld in atl 
higher numbereds non-defective sectors to Increase the ltogicai sector 
number stored in each address field by one» Refer to the discussion of 
setting sector flaws below. Finallflys the RESTORE DATA module Is used to 
copy the original track contents from the meintenance track to the 
original track. 


Flawing can be performed onty when NOS/VE Is off-line. Howevers 
fianing may be performed on—iine on NOS using MALET or off-fine using 
DEMOT. 


Fallures reported to the MDD console have cylinders track and sector 
reported in decimal. Refer to the saction on MDD feilura reporting to 
determine how to find the octal representations If necessary. 


The FMU package Is used to perform flawinge. FMU Is capable of 
sccepting the flaw addrass In either octal or decimai. Octal vaiues for 
cylinders track and sector are the default. <A post radix of D indicates 
the specified value is in decimal. 


A2e5e1 SETTING SECTOR FLAWS ON THE 885-1X DEVICE 


The fallure data displayed to the MDD console or togging in NOS/VE*s 
Engineering tog provides the address of a defect in terms of cylinders 
track and sector. The sector address is lagical end not physical. 


This distinction can best be explained by an example: 


Suppose that track N has no flawed sectors. Then a defect is reported 
by NOS/VE on this track at sector 0. In this case sector 0 is both the 
logical and physical address of the defect. Some time tater another 
defect Is reported at the same address» i»e. sector Ge This time the 
physical sector number Is 1 becausa physical sector 6 has already been 
flawed. 


Because the togical address is reported in the failure datas the 
maintenance person must use FMU to read the Utility Map map to determine 
the location of any existing defective sectors on the track. Then the 
logical sector address must be converted to a physical sector address 
and the sector flaw set based on the ohysical address» The mapping from 
logical to physical Is as follows: . 


P=t + D 
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Where: 


P is the physical sector address to be given to FLAW SECTOR module 
of FMU 


L is the logical sector address reported 
D is the number of defective sectors already set whose address is 
less than or equal to L 
It is better to set sector flaws than track flaws because the 885-1x 
does have the two spare sectors per track for this purpose. Therefore 


up to two sectors per track may be flawed without losing the full track 
capacity. Once a track flaw Is set then NOS/VE will not use the tracke 
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A3.0 DUAL STAIE_ DEVICE MANAGEMENT 
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A4.0 MOD. CONSOLE _EAILURE REPORTING 


The NOS/VE monttor will format and display failure data on the MDD 
console for every unrecovered disk fFallure regardiess of the impact the 
failure has on the system. If the system can continue executing CP 
tasksy the failure data wlll also be put In a binary engineering tog. 


If the system cannot sustain task executions the failure data wil! 
only be displayed on thea MDD console; no error flogging can occur as 970 
other fogging media (save real memory) ts available to the monitor. 


The following information will be displayed for unrecovered disk 
failures: 
ae Channel number of disk controller (in decimal) 
be. Equipment number of disk controller 
ce Disk unit number (in decimal) 
844—-4x unit numbers are 0 «2 7 
885<1x unit numbers are 32 «2 47 
d. Logical operation performed at time of failure 
READ . 
WRITE 
WRITE INITIALIZE 
READ FLAW MAP 
DRIVER INITIALIZATION 
@®. English description of failure symptom if it can be determined 
SOFTWARE FAILURE ~ (CP/PP interface fallure) 
INDETERMINATE = (channel or controlter or unit) 
INPUT CHANNEL PARITY 
GUTPUT CHANNEL PARITY 
CONTROLLER FAILURE 
UNIT FAILURE 
FUNCTION TIMEOUT (not RAM~-parity Induced) 
UNIT RESERVED 
CONTROLLER RESERVED 
SEEK FAILURE | 
ERROR IN CHECKWORD 
CONTROLLER RAM PARITY 
INCOMPLETE SECTOR TRANSFER 
UNIT NOT READY 
UNIT OFFLINE OR NOT CABLED (844) 
UNIT READ ONLY SWITCH ON (885) 
CHAN ENABLE SWITCH GFF/UNIT NOT CABLED (885) 
FLAWED TRACK 
FLAWED SECTOR (844) 
SECTOR ADDRESS MISCOMPARE 
CYLINDER ADDRESS MISCOMPARE 
LOST CONTROL WORD 
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TOU OUTPUT PARITY 

INDETERMINATE OUTPUT PARITY 
fe Cylinders Track and Sector of media faliure (in decimai) 
ge Octal display of general status (last failure status) 
he Octal display of detailtad status (last failure status) 
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Note that If the presentation of unit numbers, cylinders, track and 


sector in decimal Is a problems the detailed status does contain these 
values in an octal representations as follows: 


844~—4x 1119 98765432186 
word 4 UUU UU UU Ws unit number) 
5 CC Cccccecccr Tt tT 
6 TTssssSs8 5 (CylindersTracksSector) 
B85—1~x 1110 9876543210 
word 4 UU UU DU L(U= unit number) 
5 | ccecccec 
6 ©€¢ececcrrrrtrtrytyt (CylinderstracksSector) 
7 3$8$585 855855 . 
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A5.0 EAILURE LOGGING 


NOS/VE togs fallure data in the ENGINEERING LOG. Refer to the 
sactions below for specific information on the log entry content. 


Each {item In the ENGINEERING LOG Its called a statistic. Information 
follows concerning identification of statistics in this log. 


If problems with mass storage or tape peripherels are suspected, the 
DISPLAY_UBINARY_LOG utility may be used to extract a subset of the 
ENGINEERING LOG pertinent to the source of the problems, depending upon 
the degree of problem isolation already done. 


A good habit for the site to follow is to use DISPLAY _BINARY_LOG at 
the time that the ENGINEERING_LOG Is terminated via the TERMINATE LOG 
command to list the mass storage and tape statistics for the day. IF an 
intermittent failure should davelops a picture of how the peripheral hes 
performed In the recent past may be Invaluable In debugging the problem. 


A5o1 SIATISTIC_IDENIIELER 


The configuration management statistics willl have '"CM* as the 
idantifier. 


A5e2 STATLSIIC. cape 


The configuration management statistics wili be identified by the 
codes 350000..359999. 


A5.3 RELATION. TO_QIHER_STAIZTSTICS 


The sfp$emit_system statistic Interface captures some information 
from the emitting job and task environment and places this in the 
emitted statistic. The Jullan date (yyyyddd)» time (hhemmtss.ms)»s job 
name (system-supplied) and global-task~id (system—supplied) are 
provided. . 


At present all the disk-related statistics are emitted from a 
*system? job. Therefores the job name and globai-task-id data are of no 
vatue. However, the tape-related statistics are emitted from within the 
environment of the job using the tape hardware elements. Therefore one 
may use the JM169900 statistic to determine the user name of the Job 
owner and the JM180CG01 statistic to determine the user-suppiled job name 
of the job which emitted tape-related statistics. 
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For examples the following command sequence extracts all the 
#3M180000" entries in the STATISTIC tog to the file LISTING. Then the 
EDIT_FILE command Is used to peruse the output to find a particular 
entry. 


DISPLAY_BINARY_LOG T#STATISTIC O=LISTING 
DEFINE GROUP GtUSERLNAME $=J4180000 
DUMP_GROUP G=USER_NAME 

QuIT 

EDITLFILE LISTING 
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SD ND SED ED UD ED CO ED ED REP INO ED SEED CI ET ROD GORE TEED OED GED ID GID IE RAY ED SENSED RED AGES GED CD RAE ED ATED EP AKS AD ED AEE? A GE ee GA MD OE WS A ke AS RY ED GD Ge ET eb Oe SED GED OED EEO GED ES teem a ae ae 


A5e4 SAMPLE_PROCEDURES FOR DISPLAYING EAILUBE_DATA 


The following SCL procedures are provided as an example of how to use 
DISPLAY BINARY _LOG to obtain failure data. 


A5e4el DISPLAY_DISK_FAILURE_DATA 


PROC displayidisk_ faliure data sdisdfd ( eo. 
jogsi: file =$local.$engineering_ logs oe. 
outputso: file = $output) | 
display ubinary_log it=$value(tog) o=$vaelue(output) 
define group system_action statistic=€M3500909 
define group software failure statistic=CM350001 
define group $7154 _fallure statistic=C€M350002 
define group $7155 fallure statistic=C€M350003 
dump_group group=system_action cf={(€1.2498)9(5027910)) 
dump group group=software_ failure cf=((1..498 )9(50289160)) 
dump group group2$7154_failure e. 
Cfa( (1.0498) 5 (50210910) 5 (11221698) 5 (17219)5 (18..6098)) 
dump group group=$7155_failure «-. 
of2( (1. 2498)59(05-..2190919)51(11.21698)5117910)5 (18.26098)) 
quit 


PROCEND display_disk_fallure_data 
A5de4te2 DISPLAY _TAPE_ FAILURE DATA 


PROC display_tape_fallura_data sdistfd ( o. 
fogsi: file =Slocal.tengineering_log3s «+ 
outputso: file = Soutput) 


display binary Jog I=S3value(iog) o=Svatue(out put) 
define group group2$7021_fallure statistic=€43510C2 
dump _group group=$7021_failure o- 
ofe( (1. 04a BD)» (6009916) 9010. 22598) v0 
(266228910) 9129916) 9 (30910) 5 (316 26298)) 
quit 


PROCEND display _tape_failure data 
A525 DISK=RBELATED STATISTICS 

The statistic codes 35060900 es. 350999 will be set aside for disk 
related conflauration management statistics. 


The following codes will be Initially defined: 


350000 — System Action. Documents significant avents/actions related 
to the disk configuration. 
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350091 - Software Failure Data. Documents software fallures detected 
by NOS/VE software. 


350002 - 7154 Disk Controller Fallure Data. Documents hardware 
fallures detected by NOS/VE software. 


350093 —- 7155-1 and 7155—1x Disk Controller Failure Data. Documents 
hardware fallures detected by NOS/VE software. 


A505e1 DESCRIPTIVE _DATA PORTION OF STATISTIC 
The descriptive-data portion of the disk related statistics have the 
following contents: 
<mf>.<pp>.<channel>.<controtller>.<unit>*<vsn>*<severity>*<symptom>* 


where <mf> Is the name of the mainframe specifled when the physica! 
configuration was Instatted. 


where <pp> Is the string *#PPnt where n is the PP number In decimal of 
the PP which performed the i/o operation which is being reported. 


where <channel> is the string *CHANNELn*® where n is the channel 
number over which the I/o request was processed. 


where <controlier> is the element name of the disk conc nauter used in 
the falling request, 


where <unit> is the element name of the failing disk storage device 
used in the failing request. 


where. <vsn> Is the recorded-vsn of the disk volume which was the 
object of the falling request... 


where <saverity> is the string ‘"UF* or $$'RF* for igunrecovered and 
recovered fallure severitys respectively. 


where <symptom Is the symptom/action statement provided by the 
system. 
A5e5.2 COUNTERS PORTION OF STATISTIC 

For recovered disk fallures the Initial fallure data is logged. For 
unrecovered disk failures both the initial and final fFaliure data is 
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logged. 


The COUNTERS portion of the disk-related statistics have the 
following contents: 


Note that bit O (left-most bit) of the counter word Indicates the 
presence or absence of Information In the remainder of the word. If bit 
0 Is not set» then the contents of the word contain a bonafide value as 
documented below,. 


A5e5e2e1 System Action.=_330000 


1. PP number 
Ze Channel Number of Controller 
3. Equipment Number of Controller 
4s Physical Unit Number (Cif action related to a unit) 
5 Unitetype (Identifles the kind of units lee. product id) 
l= 844—-4x 
2 =- 3885—1x 
6- Controller-type (identifies the kind of controller) 
; - 7154 
- 7155-1x 
7» aoe Action Code (tells what the system did) 
1 - CONTROLWARE RELOADED 
2 ~ CONTROLLER DOWNED 
3 —- UNIT DOWNED 


A5.5e2e2 Softuara Esllure.~_350001 


1. PP number 
2¢ Channel Number of Controller 
32 Equipment Number of Controtter 
4. Physical Unit Number (if failure related to unit) 
5. Wnitetype (Identifies the kind of unity eae product id) 

1 = 844—4x. 

2 =~ 385-1x. 
6+ Logical Operation Code (tells what the system was trying to do) 
7e Failure Severity . 

9 - Recovered Failure 

a =~ Unrecovered Fallure 

8. soo ier Symptom Code (telis what the system thinks Is wrong) 
- Address of PP_Communicatlion Area not on word boundary. 

2~ Reserved fleld of the PP_Communication Buffer descriptor 
is non-zero | | 
Reserved field of the PP_Request_Queue descriptor Is 
non_zero 
4 - Logical unit number in Unit. Descriptor not in sequence 

or out of range 

~- Address of Unit _Interface_ Table not on word boundary. 


re) 
§ 
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6 - Unit Descriptor contains Invalid channel number 

7 ~ Communication Buffer length not a multiple of words or 
not tong enough 

8 = Reserved field after number_of_unIits component of the 
PP_Interface_Table is non-zero 

9 =- Invalid physical-unit-number in Unit Descriptor 

10 - Logical_unit number of Unit Interface _Tabte not equal 
to vaiuve In Unit Descriptor 

11 - Address of Unit Communication Suffer In 
Unit Interface_Table not on word boundary 

12 ~ Reserved field of Unit Communication Buffer Is non-zero 

13 —- Reservad field of Unit _Request_Queue descriptor is 
non zero 

14 —- Invalid unit-type in Unit Interface Table 

15 - Unit _Communicatlion_Buffer length not word multipte 

16 = Unit_Communication Buffer length too small 

-Invalid secondary address in i/o request header 

Invalid i/o request command code 

Invalid length field In indirect address list 

Invatid command sequence 


A5.50203 7154 Failuce -_ 350092 


1. PP number. 

2e Channel Number of Controller 

32 Equipment Number of Controlter 

4. Physical Unit Number (if failure retated to unit) 

52 Unit-type (identifies the kind of units J.e. product Id) 

Ll = 844-4x | 

2- 885—1x (7155 controller onty) 

6. Logical Operation Code (tells what the system was trying to do) 
-~ read 
- write 
- write initialize (sets unwritten areas to preset_value) 
- read. tian _map 
- disk udriver— initialization: 
7. Feiture Severity | 
0 - Recovered Fallure- 

jl = Ynrecovered Failure 
8. Fallure Symptom Code (tells what the system thinks is wrong) 

1 - INDETERMINATE (channel or controller orunit) 

2 ~ INPUT CHANNEL PARITY =- On an input from controller to PP 

the channel-error-flag was set. 

3 - QUTPUT CHANNEL PARITY —- On an output from PP to controller 
the controller reported a parity error In detalled status 
but the channel-error-flag was not set. 

~- CONTROLLER FAILURE - {reported by controller) 
UNIT FAILURE 
~ FUNCTION TIMEDUT - (controltler not responding) 


Pp 
fees 


ou 
‘ 
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7 ~ UNIT RESERVED - (unit reserved to opposite access) 
During i/o request processing the PP driver attempts 
to connect to the target untt. If it cannot connect 
to the units this statistic is generated. The driver will 
terminate the i/o request as a result. 

8B = CONTROLLER RESERVED - (to another channel) 

During i/o request processing the PP driver attempts 

to obtain the coupler reservation. If not successful for 
16 secondss this statistic Is generated. The driver will 
continue to try to obtain the coupler reservation until 
successful. 

9 ~ SEEK FAILURE 

10 — ERROR IN CHECKWORD 

11 - CONTROLLER RAM PARITY 

i2 — INCOMPLETE SECTOR TRANSFER 

15 ~ UNIT NOT READY — START switch offs unit not spun up or 
dropped ready 

16 — UNIT OFFLINE OR NOT CABLED - 844 unit has switch on back 
of unit in offline position or unit not cabled 
to controller. 

17 - UNIT READ GNLY SWITCH ON - 885 unit has write-iInhibit 
switch set 

28 ~ CHAN ENABLE SWITCH OFF/UNIT NOT CABLED —- 885 unit has 
CHAN ENABLE switch off or unit Is not cabled to controiler 

19 — FLAWED TRACK - a sector with a track flaw bit set 
has been read/written. This may Indicate that the Utility 
Map is wrong or there Is a NOS/VE software problem. 

20 —- FLAWED SECTOR = a flawed sector on an 844 unit has been 
read/written. This may Indicate that the Utility MAP Is 
wrong of there is a NOS/VE software problem. 

21 — SECTOR ADDRESS MISCOMPARE 

22 — CYLINDER ADDRESS MISCOMPARE 

23 —- LOST CONTROL WORD 

24 —~— IOU QUTPUT PARITY = On an output from PP to controller 
both the channel—error-flag and the controller*s detalied 
status Indicated a parity error occurred. 

25 —- INDETERMINATE OUTPUT PARITY - On an output from PP to 
controller the channel-error-flag was set but there was no 
arror reported by the controller. This may mean there is a 
problem in the I0u and/or the shannel and/or the controller. 

9. Request Retry Count 
The number of times the PP driver retried the i/o request 
from the beginning. 

10. Sector Ratry Count 
The number of retries that the PP Pere performed on the 
failing sector on the last atceant to retry the i/o 

request. 
ll. Cylinder number of initial seek 
12. Track number of Initial seek 
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13. Sector number of initial seek 

14. Cylinder number of fallure 

15. Track number of faitura | 

16. Sector number of fallure 

17- Restdual byte count on Incomplete channel transfer 

18. Feiting Function 
The function that caused the Initial recovery attempt. 
The value is extracted from the Initial detailed status if 
the controller provides status after the failure. On a 
function timeouts the function reported is the one which 
was outstanding when the controller hunge 

19. General Status of Initial Failure 

20. Detailed Status of Initial Fallure- Word 1 


2 

39. Detailed Status of Initial Failure- Word 20 

The fottowing counter words are only present for unrecovered 
disk fallures. They rapresent the status from the last 
unsuccessful attempt at recovery. 

40. General Status of Last Fallure 

41. Detailed Status of Last Failure - Word 1 


» 


60. Detailed Status of Last Falfure - Word 20 

Ao 250204 71395 -1x Eailurce -.359003 

Refer to 7154 for specific content. 

A5.6 TAPE-RELATED_ STATISTICS 

The statistic codes 351000 .. 351999 will be set aside for tape related 
configuration management statistics. 

The following codes will be Initially defined: 


351600 - System Action. Documents significant events/actions related 
to the tape configuration. This will be supported In NOS/VE R1.1. 


351002 - 70621—-3x Tape Controller Failure Data. Documents hardware 
fallures detected by NOS/VE software. 


The statistics defined above have the following general format: 
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A5e6el DESCRIPTIVE_LDATA PORTION OF STATISTIC 


The descriptive-data portion of the tape related statistics have the 
following contents: 
*<mf>.<pp>.<channel>d.<controtierd.<unit>*<vsn>*<severity>*<symptom>* 


where <mf> is the name of the mainframe specified when the physical 
configuration was Installed... 


whera <pp> Is the string *PPn! where n is the PP number In decimal of 
the PP which performed the i/o operation which is being reported. 


where <channel> is the string *CHANNELn*® where n is the channel 
number over which the I/o request was processed. 


where <controller> is the element name of the tape controller used in 
the failing request. 


where <unit> is the element name of the failing tape storage device 
used in the failing request. | | 


where <vsn> is the external-vsn of the tape volume which was the 
ob jact of the falling request. 


where <severity> Is the string ‘UF or 'RF* for unrecovered and 
recovered failure severitys respectively. 


where <symptom> is the symptom/action statement provided by the 
system. 


A5e6e.2 COUNTERS PORTION OF STATISTIC 

In NOS/VE RieOe2s onty the tast fallure encountered during an 
unrecovered i/o operation will be logged. In NOS/VE R1.0039 the format 
of the following statistic will change to report the initial faiiure 
data for recovered faliures and both the Initial and final failure data 
for unrecovered fallures. 


The Historical and Current Block Id Windows are only appended if the 
Failure Symptom Code Is "TAPE MEDIUM FAILURE!. 


The general format of the COUNTERS portion of the statistic is as 
follows: 


Note that bit 0 (left-most bit) of the counter word indicates the 
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presence or absence of Information In the remainder of the worde If bit 
C is not sets then the contents of the word contain a bonafide value as 
documented below. 


A5e6020e1l 2O2ZI-3x_Ealluces.~_331002 


1. PP number 
2e Channel Number of Controller 
32 Equipment Number of Controller 
4e Physical Unit Number (if fallure related to unit) 
5. Unit-—type Cidantifies the kind of units, eae product id) 
- 679-2 
679-3 
679-4 
679-5 
6796 
679-7 
al Operation Code (tells what the system was trying to do) 
read 
write. 
rewind 
unload 
clear reserve 
write tapemark 
data.security_erase. 
forespace 
backspace 
0 - forespace_tapemark(s) 
11 - backspace _tapemarki{s) 
12 — getistatus 
13 - TCULloopback 
14 - Unit loopback I 
15 = Unit lloopback IT 
7. Fallure Severity 
0 - Recovarad Falture 
1 - Unrecovered Failure 
8. Failure Symptom Code (tells what the system thinks Is wrong) 
1 - INDETERMINATE (channel or controller or unit) 
2 ~- INPUT CHANNEL PARITY - On an Input from controiler to PP 
the channel-error-fiag was set. 
DUTPUT CHANNEL PARITY — On an output from PP to controiler 
the controliar reported a parity error in detailed status 
but the channel-error-flag was not set. 
CONTROLLER FAILURE ~- (reported by controller) 
UNIT FAILURE 
FUNCTION TIMEOUT - (controiler not responding) 
UNIT RESERVED = (unit reserved to opposite access) 
13 ~ TAPE MEDIUM FAILURE 
14 — ERASE LIMIT EXCEEDED 


rieereraite ag pis 


be Log 
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| 
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24 - I0 OUTPUT PARITY - On an output from PP to controller 
both the channel-error-filag and the controller's detailed 
status indicated a parity error occurred. 

25 ~ INDETERMINATE OUTPUT PARITY —- On an output from PP to 
controller the channel-error-flag was set but there was no 
error reportad by the controller. This may mean there is a 
problem in the IDU and/or the channel and/or the controller. 

9. Retry Count (telis how many times the driver performed retry) 
10. General Status —- Word 1 

ll. General Status — Word 2 

12. Detailed Status - Word 3 


252 Detailed Status —- Word 16 

262 Biock Count From Beginning of Tape - This indicates the 
displacement from the beginning of the tape at the time 
the fallure occurred. . 

27. Total Blocks Read — This indicates the total number of biocks 
read by a Job since the tape volume was mounted on this 
tape transport. 

28. Total Blocks Written - This Indicates the total number of biecks 
written by a job since the tape volume was mounted on this 
tape transport. . 

29. Requested Format (Describes options selected by driver) 

30. Density of Tape Used 

31. Historical Block-id Window - Word 1 (!atest) 


466 Historical Block-id Window - Word 16 loldest) 
47. Current Block~id Window — Word 1 (latest) 


| 626 Current Block-id Window — Word 16 (oldest) 
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A7.0 RECONEIGURATION 


A7s1 ASSUMPTIONS 


1. The reader is already familiar with the NOS/VE Installation and 
deadstart process but ts not familiar with what to do in 
particular failure situations. 

2 The system analyst will took at the MDD display for feilure 
information in the event of a system fallure. If the system has 
not failed but peripherat failures are suspecteds the system 
analyst will ifook at the Engineering Log for fallure information. 

3e The site has generated a deadstart tape with the specified 
Physical and logical configurations as depicted below. Uniess 
otherwise specifieds assume the site has Installed NOS/VE»s has 
been running the systems has permanent files on disk and has 
backup tapes of the permanent files. 


A7.2 EAILURES_NOT_REQUIRING RECONEIGURAIION 


If the performance of the system Is degrading and there is an MDD 
consoles see If unrecovered disk fallure(s) have been reported. 
Aiternativelys use the DISPLAY_UBINARY_LOG command to determine whether 
unrecovered disk/tape fallures have been reported In the Engineering 
Log. 


The first aiternative to consider when a peripherai fsilure is 
suspected Is to terminate NOS/VE (Cif still running) and revert to NGS 
(single=-state execution). When NOS/VE is terminateds all devices remain 
DOWN In the NOS configuration. Therefore MALET may be used on NOS to 
isolate and repair paripheral hardware problems. If the problem Is a 
hardware togic failure and Is repaireds one should be able to perform a 
continuation deadstart and resume normal operation. If this alternative 
is not chosen and the failing element is the system deadstart controlier 
or disk drives any modified data In NOS /VE real memory at the time of 
the failure will be fost. 


If rapair will. take too long or files will be fost as a result of the 
failures the discussion below is pertinent. 


A723 CONFIGURATION. #1_=_SINGLE CONTROLLER 


Note that the disk and tape units are only accessible from one 
controller. This is not a recommended configuration from the 
standpoints of fault tolerance and system performance. Compare the 
following scenarios with those of configuraton #2. 

channel G channel 2 channel 6 
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A7.3 CONFIGURATION #1 —- SINGLE CONTROLLER 


H ; H 
H H ; 
disk disk tape 
controller controller controller 
3 a 
7 
unit O---— (system) unit 3---3 unit4d-—3 
a | 
. ] 
i 


unit le-=-}. unit 4-<- 


A7.3e1 DISK RECONFIGURATION SCENARIOS 


Listed below are scenarios for possible disk faliiures which require a 
NOS/VE deadstart or which occur while deadstarting NOS/VE. Assume that 
in each case the desired recovery action Is to change the configuration 
end resume operations as soon as possible. In the discussion below a 
*bad HDA’ refers to the disk pack mounted on a disk drive; failures such 
as head<—crash or a bad head may cause data to be recorded improperty or 
to be Incapabie of being read. . 

1. Assume 1) a bad HDA on disk #1 (not system device) or 2) a fallure 

tn disk drive #1 which will take too tong to repair and no spare 
disk drive. The desired result Is to delete disk #1 and continue 
degraded operation with only 1 disk (#0) on channel #0. 

ae Rebulld the NOS/VE deadstart tape with a new configuration 
prologe. The new proiog should have the falling device in 
the physical configuration but not in the togical 
configurations Te@e the INSTALL LOGICAL CONFIGURATION 
subcommand of the LOGICAL _ CONFIGURATION_UTILITY (LCU) should 
fexciude! the falling element. In addition the 
configuration prolog may need to be changed If it was set up 
to INITIALIZE_MS_ VOLUME and ADD _VOLUME_TO_SET for the 
falling element; these subcommands must be deleted. 

be. Perform an *instailation deadstart*® of NOS/VE. 

ce. Reload permanent files. Since you now have only 3 disks, 
you. may need to reioad files for a subset of the users and 
tell the rest of your users to wait for the fourth disk to 
-be repaired. 

de Resume operation In a degraded mode. 

@. When the failing disk has been repaireds execute the LCU to 
re~instell the logical configuration to 'tinclude*® the 
repaired element. Note that the newly Installed togical 
configuration will not become active until the next 
continuation deadstart. | | 

f. When convenient do a TERMINATE SYSTEM and then a 
continuation deadstart. This wlll activate the tegical 
configuration installed above. 
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ge Execute the LCU to INITIALIZE MS VOLUME and 


ne 
i» 


2e Assume 


ADDL VOLUME_TO_LSET for the repalred element. 
Reload any permanent files not previously reloaded. 
Continue with normal system operation. 
1) a bad HDA on disk #9 (system device) or 2) a failure in 


disk drive #0 which will take too tong to repair and no spare disk 


drive. 


The desired resutt Is to delete disk #6 and continue 


degraded operation with onty 1 disk (#1) on channel #0. 


De 
Se 


de 


Be 


fe 


ge 
he 


Rebulid the NOS/VE deadstart tape on the NOS system. The 
SET_DEADSTART_DEVICE system—core command must be changed to 
refiact the type of unit and the unit-number (1) for the new 
system disk. The configuration prolog must also be rebullt. 
The new protfog should have the failing device (0) in the 
physical configuration but not in the logical configurations 
ieee the INSTALL LOGICAL CONFIGURATION subcommand of the 
LCU. should texctude’t the falling element. In eddition the 
configuration prolog may need to be changed [if it was set up 
to INITIALIZE_MS_ VOLUME and ADDUVOLUME_TO_SET for the new 
system device; these subcommands must be deleted. 

Perform an ‘installation deadstart’® of NOS/VE. 

Reload permanent files. Since you now have only 3 disks» 
you may need to reioad files for a subset of the users and 
teli the rest of your users to walt for the fourth disk to 
be repaired... 

When the falling disk has been cenaivads execute the LCU to 
re~instal!l the logical configuration to ‘finciude! the 
repalred element.  8Note that the newly instailed ltogical 
configuration will not become active until the next 
continuation deadstart. 

When convenient do a TERMINATE SYSTEM and then a 
continuation deadstart. This will activate the togical 
configuration Installed above. | 
Execute the Lcu to INTITIALIZE_ MS VOLUME and 
ADD_VOLUME_TO_LSET for the repalred element. 

Reload any permanent files not previously reloaded. 

Continue with normal system operation. 


32 Assume 1) a bad HDA on disk #3 (not system device) or 2) a fallure 
in disk drive #3 which will take too long to repair and no spare 
disk drive. The desired result Is to delete disk #3 and continue 
degraded operation with only 1 disk (#4) on channel #2. 


Rebulld the NOS/VE deadstart tape on the NOS system. The 
configuration proiog will need to be changed. The new 
prolog should have the failing device in the physical 
configuration but not In the logical configurations ti.@. 
the INSTALL _LOGICAL_CONFIGURATION subcommand of the 
LOGICAL_CONFIGURATION_LUTILITY (LCU) should ‘exclude* the 
falling element. In addition the IiInitialization prolog may 
need to be changed If It was set up to INITIALIZE _MS VOLUME 
and ADDU VOLUME_TO_LSET for the failing device; these 
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bd» 
Ce 


de 


f. 


Qe 
he 


subcommands must be deleted. 

Perform an *instaliation deadstart® of NOS/VE 

Reload permanent files. Since you now have only 3 disks» 
you may need te reload files for a subset of the users and 
tell the rest of your users to wait for the fourth disk to 
be repaired. 

When the failing disk has been repaireds execute the LCU to 
‘include the failing element in the Installed togical 
configuration. Note that the newly instaifed logical 
configuration will not become active until the next 
continuation deadstart. 

When convenient do a TERMINATE_SYSTEM and then a 
continuation deadstart. This will activate the togical 
configuration instafited above. 

Execute the LCU to INITIALIZE MS_ VOLUME and 
ADDU VOLUME_TO_LSET for the repaired element. 

Reload any permanent flies not previously reloaded. 

Continue with normal system operation. 


4, Assume the controller on channel #0 requires repair and that the 


rapalir 


wil! take too longe The deslred result Is to delete the 


failing controiler from the configuration and continue degraded 
operation with the single controtler on channel #2. 


Aa 


be 


Ce 
de 
Re 
fe 
Je 


be 


Ke 


Have a Customer Engineer recable units 0 andi to the 
controller on channel 2. 

Rebulid the NOS/VE deadstart tape on the NOS system. <A new 
configuration proiog is required. The new prolog should 
show units 6 and 1 being connected to the controfter on 
channel 2. The configuretion prolog should atso be changed 
to 'exclude't channel 90 from the Instailed logical 
configuration. The SET UDEADSTART_CONTROLLER system-core 
command may need to be changed if the controfler on channel 
#2 has ai different product_identification than the one on 
channel #0. 

Do a SETVE to change the deadstart channel number from 0 to 
Ze 

Perform an "installation ddsavtare’ of NOS/VE. 

Reload permanent files. 

Continue degraded system operation. 

When the failing controltier has been repaireds use the 
INSTALL _PHYSICAL_CONFIGURATION | subcommand of the 
PHYSICAL _CONFIGURATION_LUTILITY to re~instali the original 
physical configuration. Note that the newly installed 
physical configuration wil! not become active until the next 
continuation cig 

When convenient do TERMINATE_SYSTEM. geesnriaa cannot 
occur whlie the NOS /VE system is executing. 

Recable to match the instailed physical configuration. 
Perform a continuation deadstart. 

Continue wlth normal system operation. 
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5. Assume the controller on channel #2 requires repair and the repair 
will take too tong. The desired resuit is to delete the failing 
controller from the configuration and continue with the remaining 
controller on channel #0. 

ae Have a Customer Engineer recable units 3 and 4 to the 
controller on channel #0. 

be Rebulid the NOS/VE deadstart tape on the NOS system. A new 
configuration prolog is required. The new proliog should 
Show units 3 and 4 being connected to the controiier on 
channel! #0. The configuration prolog should elso be changed 
to ‘excludet channel 2 from the instalied jogical 
configuration. 

ce Perform an "installation deadstart' of NOS/VE. 

d. Reload permanent files... 

@e Continue degraded system operation. | 

f. When the failing controlier has been repaireds use the 
INSTALL PHYSICAL CONFIGURATION subcommand of the 
PHYSICAL _CONFIGURATION_LUTILITY to re-install! the original 
physical configuration. Note that the newly instaliied 
physical configuration does not become active until the next 
continuation deadstart, 

ge When convenient do ai TERMINATE_SYSTEM. Recabling cannot 
occur while the NOS/VE system is executing. 

he Recable to match the Installed physical configuration. 

i. Perform a continuation deadstart. This will activate the 
physical configuration Installed above. 

je Continue with normal system operation. 

6. Assume 1) the HDA on disk #1 (not system device) is not damaged 
and 2) the fallure in disk drive #1 will take too long to repair 
and 3) a spare disk drive. The desired result Is to delete the 
faliing devices to move the disk pack from the failing drive to 
the spare drives and to continue normal operation. 

ae This assumes that a spare disk drive hes been physically 
configured and that the disk pack (HDA) normally mounted on 
the drive is not currently used by NOS/VEs tI.e. the disk 
drive is defined in the Installed physical configuration but. 
not in the instatted togical configuration. If these 
assumptions are not vatlids then fotlow one of the earlier 
scenarios concerning a failing disk drive. 

be Remove the disk pack (HDA) fron drive #1 and mount It on the 

spare drive, : 

Ce Perform a continuation deadstart and request operator 
interventions | 

de From within the LCU use the INSTALL_LOGICAL_ CONFIGURATION 

 subcommand to ‘exclude’ drive #1 and tinclude' the spare 
drives . 

2. Continue normal system operation. 

7+ Assume 1) the HDA on disk #6 (system device) is not damaged and 2) 
the failure Is in disk drive #6 which will take too tong to repair 
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and 3) a spare disk drive. The desired result Is to delete the 
falling devices, to move the disk pack (HDA) from the failing 
device to the spare device and to continue normal operation. Note 
that 885—1x (FMD) HDAs can be removed by a CE and moved to a spare 
drive. Operators can move 844—4x drives themselves. 
ae This assumes that a spare disk drive has been physically 
configured and that the HDA normaily mounted on the storage 
device is not currently used by NOS/VEs J.e. the disk drive 
is defined in the installed physical configuration but not 
in the installed logical configuration. If these 
assumptions are not valids then follow one of the earlier 
scenarlos concerning a falling disk storage element. 
b., Remove the disk pack (HDA) from drive #0 and mount the pack 
on the spare drive. 
ce If the disk pack was moved to channel #2 use the SETVE 
command to change the deadstart channel from 9 to 2. 
de Perform a continuation deadstart and request operator 
intervention. 
ee If necessary change the SET_DEADSTART CONTROLLER system—core 
command to specify the product-identification of the 
controller. 
ft. Change the SET LDEADSTART_DEVICE system-core command to 
identify the unit number of the spare drive. 
ge From within the LCU use the INSTALL _LOGICAL._ CONFIGURATION 
subcommand to ‘excludet drive #0 and "inctude* the spare 
drivee 
he Continue normal system operation. 


A7.3.2 TAPE RECONFIGURATION SCENARIOS 


Listed below are scenarlos for possible hardware fallures which may 
eccur (or be detected) while using tape peripherals as configured In 
configuration #1. | . 

@e Assume a failure in the tape controlter has caused a NOS/VE 
interruption. The desired result is to remove the failing tape 
controlier from the NOS/VE configuration to allow diagnosis and 
repair to occur in the NOS state concurrent with NOS/VE execution. 

@e Perform a continuation deadstart and request operator 
intervention. . 

be From within the LCUs re-install the logical configuration 
and texclude! channel 6. 

ce. Continue operation without the tape controller. 

de. When the tape controller has been repalreds execute the tLCU 
to re-install the togical configuration and ‘tinctudet 
channel! #6. Note that the nenly Insteiied fogicai 
configuration will not become active until the next 
continuation deadstart. 

@.e When convenient do aeéTERMINATE_SYSTEM and perform a 
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De 


ds 


continuation deadstart to activate the newly installed 
logical configuration. 
f. Continue with norma! operation. 
Assume a failure in the tape controller which does not cause a 
NOS/VE interruption. The desired result is to remove the failing 
controlier from the NOS/VE configuration to allow diagnosis and 
repair of the element to occur in the NOS state concurrent with 
NOS/VE execution. 
ae Execute the LCU to re-install the logical configuration and 
: Yaxcilude! channel #6. Note that the newly installed iogical 
configuration does not become effective until the next 
continuation deadstart. 
be When convenient do ai TERMINATE SYSTEM and perform a 
continuation deadstart. 
ce Continue operation without the tape controlier. 
de When tha tape controller has heen repaireds repeat the 
process above to 'include’* channel #6. 
Assume that tape unit #40 has failed. Also assume that this 
falflure has not caused a NOS/VE Interruption. The desired result 
is to replace unit #40 with a different tape unit from the NOS 
configurations use the NOS state for diagnosis and repeir of the 


falling element and continue NOS/VE execution. 


ae Use the PCU to re-install the physical configuration 
omitting the falling tape unit and adding the replacement 
tape unit. Note that the newly instalied physical 
configuration wih not become active untit the next 
continuation deadstart. 
be. Use the LCU to re-install the togical configuration. Note 
this Is necessary because the LCU captures some of the. 
information in the Instalied physical configuration which 
changed above. 
ce When convenient do ai TERMINATELSYSTEM and a continuation 
deadstart. 
d. Continue with normal system operations 
Assume that. tape unit #40 has falied and the failure caused a 
NOS/VE interruption. The desired result is to replace unit #40 
with a different tape unit from the NOS configurations use the NOS 
state for diagnosis and repair of the anew element and continue 


NOS/VE execution. 


@e Perform a continuation deadstart. ; 

b. After deadstart run the PCU to instali ao new physical 
configuration which omits the failing tape unit and defines 
the replacement. 

ce Do a TERMINATE_LSYSTEM and perform another continuation 
deadstart to activate the newly installed physical 
configuration. 

de Continue normal system operation. 
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A7.4 CONEIGURATION.#2_-_ SULTIPLE CONTROLLERS 


channel 0 channel 1 

a % 
disk disk 
controller controller 

a a 

3 5 ] 

: 4 

% § 

3 a 


channel 2 channel 3 
H H 
H : 
tape tape 
controller controller 
. H 
H ; 


menewenmunit lm 


Listed below are senarios for possible hardware failures that may 
require a NOS/VE deadstart or may occur while performing a NOS/VE 
deadstart. The following scenarlos can also be applied toe the case 
where the failure did not cause a NOS/VE interruption. In this case one 
can execute the LCU to ‘exctude' ai falling controllers» do a 
TERMINATELSYSTEM when convenient and then follow the steps below 
emitting the operator intervention and consequent LCU execution. 


A7e4e1 DISK RECONFIGURATION SCENARIOS 


The following describes the recommended approach for dealing with the 
failure of one of the two disk controllers in configuration #2 above. | 
1. Assume the site has configured to channel #0 unit #0 for the 
deadstart device and the controtier on channel #0 falls. The 
desired rasulf{t is to return the controller to the NOS stete for 
diagnosis and repair and to continue degraded cperation minus the 
failing controller. | 
ae Execute SETVE command to change the deadstart channel number | 
from 9 to l. 
b. Perform a continuation deadstart and request operator 
Intervention. 
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ce Change the SET UDEADSTART_ CONTROLLER system-core command if 
the product_identification of the controller on channel #1. 
is different than that of the controller on channel #0. 

de From within the LCU use the INSTALL LOGICAL CONFIGURATION 
subcommand to texclude! channel #0. 

@. Continue degraded system operation. 

f. When the falling controller has been repaireds use the LCU 
to re-install the logical configuration and Ttinctudet 
channel #0. Note that the newly installed togical 
configuration will not become active until the next 
continuation deadstart. 

ge When convenient do a TERMINATELSYSTEM and perform a 
continuation deadstert to activate the newly instalied 
logical configuration. 

he Continue normal system operation. 

Assume the controller on channel #1 falls. The desired resuit is 
to return the failing controflier to the NOS configuration for 
diagnosis and repair and to continue with degraded system 
operation minus the failing controller. 

@e Perform a continuation deadstart and ask for operator 
intervention. 

be From within the LCU use the INSTALL LOGICAL CONFIGURATION 
subcommand to texctudet channel #1. 

tc. Continue degraded system operations 

ds When the falling controlier has been repaireds use the LCU 
to re-install the tlogical configuration and ‘inciude’ 
channel #1. Note that the newly instaiied logical 
configuration will not become active untl!i the next 

 gontinuaetion deadstart. . 

@e When convenient do aéiéTERMINATE_SYSTEM and perform a 
continuation deadstart to activate the newly installed 
logical configuration. 


TAPE RECONFIGURATION SCENARIOS 


The following is the recommended approach for deating with the 
fatlure of one of two tape controllers in configuration #2 above. 


de 


Assume one of the controlters on elther channel #2 or channel #3 
fallse The desired result is to return the failing tape 
controller to the NOS state for diagnosis and repair and to 
continue degraded operation minus the falling controlifer. 
ae Perform a continuation deadstart and ask for operator 
intervention. 
be From within the LCU use the INSTALL LOGICAL CONFIGURATION 
subcommand to texciude® the channel with the failing 
controller. 
ce When the failing controller has been repaireds use the LCU 
to re-install the logical configuration and ‘inciude* the 
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de 


channel with the failing controller. Note that the newly 
installed logical configuration will not become active until 
the next continuation deadstart. 

When convenient do ai TERMINATELSYSTEM and perform a 
continuation deadstart to activate the newly instalied 
logical configuration. 
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Bl.0 PEQMANENT_EILE_ MANAGEMENT 
Biel BACKUP PERMANENT _EILE_3 BACPE 


The purpose of this command is to Initiate execution of the 
BACKUP _ PERMANENT _LFILE command utility. This utility creates backup 
copies of permanent files and catatogs. All cataiog Information (e229. 
file descriptions, access control tistss usage tog) and file contents 
are copied. The RESTORELPERMANENT_FILE utility restores files and 
catalogs from their backup copy. 3 


In generals use of the utility Is according to the same access rules 
es other Permanent File Management commands. Users can only backup 
files for which they are permitted an access_mode that includes read and 
a share mode that does not Include (appends shorten or modify). The 
System Operator can backup all files regardless of access permissions A 
backup will not be done for files that are busy. If a file is busy the 
file wlll be skipped. A file Is busy If access_mode of (read) and 
share _mode of (reads execute) cannot be obtained. This means that 
exclusive access of appands shorten and modify must be obtained. 


Files that have been accessed with an Implicit attach prior to a 
backup may be stil! attached in a mode that causes the file to be 
skipped. A timplticitiy attached flie should be explicitiy detached or 
the user should logout and togin to Insure that none of the files are 
busy that are to be backed up. 


In general If errors occur on a subcommands (such as file busy) a 
warning message is returned to the user. The user should inspect the 
fist file to determine what errors have occurred, 


utility subcommands are used to direct the backup operation. 
Capabitities include backup of specific file cycles; backup of ali 
cycles for a file; backup of all files and catalogs under a given 
catalog; backup of all filles and catalogs on the system. 


Utility subcommands are provided to allow the installation to do a 
partial backup of the permanent file base. <A partial backup allows the 
installation to only backup daily filles that have been modified on thet 
day» or since the last full backup. 


Utitity subcommands are provided to allow the installation to backup 
a subset of all the users. This allows the backup of the permanent file 
base to be divided Into a serveral sets of magnetic tapes. This also 
allows concurrent backup to occur to more then one tape device. 

Utility subcommands are provided to allow the system operator to 
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decreasa the siza of the permanent file base by backup and/or deletion. 
of files. 


Backup commands that use magnetic tape may not executed as part. of 
the system console job because of conflicts In tape assignment. 


backup_permanent_ file backup_file=<fille> 
Clist=<file raferencedl] 
Cstatus=<status varlab!e>]} 


backup file i bf: This parameter specifies the fite to which backup 
Information will be copied... Backup information resuiting from 
each subcommand issued during this Instance of utility 
execution is copied to this file. It is initially positioned 
to beginning-of-information. 


fist ${ 1: This parameter specifies the file to which a summary of 
the results of executing the backup utility are written. This 
includes a list of the names of all catalogs and files for 
which a backup copy was produced. Omission will cause $LIST 
to be used. The content of the iist file may be specified 
using the SETLLIST_OPTIONS subcommand prior to the backup 
subcommand. If the SETLLISTLOPTIONS subcommand is ommitted 
then modification date and times and size will be displayed. 


Status: See ERROR HANDLING. 

Bl.2 BACKUP PERMANENT EILE_UTILITY SUBCOMMANDS 

The following subcommands are processed by the BACKUP _PERMANENT_FILE 
utitity. 
Bl.2.1 BACKUP_LALL_FILES $ BACAF 

The purpose of this subcommand is to create a complete backup copy of 
every catalog and permanent file defined in a NOS/VE system. The file 
specified in the BACKUP_PERMANENT_LFILE command te contain the backup 
Information must be associated with magnetic tape. Oniy a system 


operator can perform this function. 


A previous INCLUDE..USERS directive may be used to select ai subrange 
of userse. 


Any catalogs files or cycle specified on a previous EXCLUDE_CATALOG 9 
EXCLUDE_FILEs or EXCLUDE _HIGHESTLCYCLES directive is not backed up. 


Previous INCLUDE_CYCLES commands may be used to creete ai paertial 
backup. A partial backup Includes all catatog Information and all 
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permanent file cycle data modified after the date specified on the 
INCLUDE _CYCLES subcommand. The catalog data is used during a restore to 
select flie cycle data from previous partial or full backup operations. 


Previous INCLUDE CYCLES» INCLUDE VOL UME S» INCLUDE LARGE CYCLES» 
EXCLUDE HIGHEST CYCLES» and INCLUDE_LEMPTY_CATALOGS along with subsequent 
DELETE_ALL_FILES subcommands may be used to reduce the files maintained 
ontine. 


backup_lalicfiles Cstatus=<status variablie>] 
status: See ERROR HANDLING. 


Exampiet to backup all files. Note that the commands submit a job to 
avoid console conflicts with tape assignment. 


job backup 
request magnetic tape file=backup evsne(*BACKL's *BACK2?) 2. 
ringzon temt9$625C 
backup _permanent_files backup _file=backup 
backup_all_files 
quit 
JjJobend 


B1.2.2 BACKUP_CATALDG |: BACC 


This subcommand is intended to be used by the user. The purpose of 
this subcommand is to create a backup copy of each file cycle and 
catalog registered relative to a specified catalog. Starting at the 
specifled catalog the complete catalog hierarchy is followed to obtain a 
backup copy of each file and its associated catalog information. 


A system operator Is permitted access to all files in a catalog. The 
owner of the specified catalog and a alternate user may obtain a backup 
for all files (and associated catalogs) to which they are permitted read 
eccess and not required to share the file for (modifys shortens or 
append). The system operator or the owner of a catalog may backup a 
file which contains a password. : 


The utility skips a file cycle if it Is busys that is {Ff tt cannot 
access the flie with an access mods of read and a share mode of {reads 
execute). Exclusive access of (modifysshorten and append) Is required. 


Previous EXCLUDE_CATALOG and EXCLUDE_FILE commands aljJow the user to 
exclude catalogs and flies from the backup. 


INCLUDE_CYCLES» INCLUDE. VOLUMES» INCLUDE _LARGE_CYCLES and 
EXCLUDE _HIGHEST_CYCLES subcommands if executed previous to this 
subconmmands may have an undesirable effect on the command. 
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backup_catalog catalog=<catalog> 
{status=<status vartablfe>] 


catalog } c: This parameter specifies the cetalog to be backed up. 
This parameter Is required. 


status! See ERROR HANDLING. 
For exampie: For a user to backup all files 


request_magnetic.tape file=backup ring=on evsn2'*MYDUMP? 

backup _permanent_ file backup _filesbackup fist=coutput 
backup _catalog catalog=Suser 

quit 


B1l.223 BACKUPLFILE | BACF 


This subcommand ts intended to be used by a usere The purpose of 
this subcommand is to create a backup copy of a specified permanent 
file. If the fite name Inctudes a cycle reference only that cycie is 
copled. If a cycle reference is omitted ali cycles of the file are 
copied. The backup is onty done if the user making the request has been 
permitted read access to the file and not required to share for (modifys 
shortens or append). 


A permanent fiie cycie wil! be skipped If it Is busys that is if it 
cannot be accessed with a access_mode of (read) and a share_mode of 
(reads execute). § Note: exclusive access for (modifys shortens and 
append).. 


A EXCLUDE_LFILE subcommand specifying a cycle number when executed 
previous to this subcommand may be used to exclude specific cycies from 
the backup. 


INCLUDE_CYCLES» | INCLUDE VOLUMES» INCLUDE _LARGE_CYCLES and 
EXCLUDE _HIGHEST.CYCLES subcommands if executed previous to this 
subcommands may have a undesirable effect on the subcommand. 


backup_file file=<file> 
Cpassword=<name>] 
Cstatus=<status variable>) 


file ! f3 This parameter specifies the permanent file or permanent 
file cycle for which a backup copy of each cycle Is to be 
obtained. 


password ! pw: This parameter specifies the flie password. It must 
match the password saved for the file. Omission will cause no 
password to be used. 
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Status: See ERROR HANDLING. 
B1.2e4 DELETE_LALL_FILES 


The purpose of this subcommand is to delete every permanent file 
created in a NOS/VE system. Previous INCLUDE_LUSERS» EXCLUDE_CATALOG» 
EXCLUDE_FILE>» INCLUDE LARGE CYCLES» INCLUDE VOLUMES» 
EXCLUDE_HIGHEST_CYCLES» and INCLUDE_CYCLES»s subcommands may be used to 
specify a subset of the permanent files to defete. This subcommand may 
only performed by the system operator. 


Empty catalogs may afso be deleted depending upon previous 
INCLUDE_LEMPTY_CATALOGS subcommand. 


This command is intended to be used following a BACKUP_LALL_FILES 
subcommand to reduce the size of the permanent file base. The fisting 
generated by the BACKUP_ALL_FILES subcommand should be reviewed to 
Insure that the files selected could be backed up before executing the 
DELETE_LALL_FILES subcommand. 


The flie will not be deleted if acess mode of (read) and a share mode 
of (reads execute) cannot be obtained. This means exciusive access for 
(modifys shortens and append) is required. The intent of this checking 
is to Insure that a file cannot be deleted that could not be backed up 
by a previous BACKUPLALL_FILES subcommand. If these operations are 
performed in a busy systems changes in file access may result in files 
being deleted that have not been previously backed ups 


delete_all_ files Ustatus=<status_variable>1 
status: See ERROR HANDLING. 
Ble2e5 DELETE CATALOG CONTENTS 3 DELETE _CATALOGG_CONTENT 7} DELCC 


The purpose of this subcommand fs to defete all files in a cataloge 


This command Is Intended to be used by the user. Qfinly the owner of a 
catatog may successfully use this request to delete a catalogs and to 
delete files with non null passwords. 


The owner of a catalog and alternate users may use this request to 
delete all files. to which they have been granted control and read access 
permissions and are not required to share for modifys shortens and 
append. That Is a share mode of (reads execute) 


If a permanent fille cycle is busy the file will be skipped. Busy 
impties the flle could not be accessed with an access_mode of (read) and 
ae share _mode of (reads execute). Note: exclusive access required for 
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(modifys shortens and append). 


If a file cycle is in use at the time of this subcommand the actual 
delete is not done until the last user detaches the file. 


If a master catatog is specified on this subcommands the master 
catalog will not be deleted, 


Previous EXCLUDE_CATALOGs EXCLUDE FILE» EXCLUDE HIGHEST_CYCLES 
INCLUDE LARGE CYCLES» INCLUDE CYCLES and INCLUDE _ EMPTY CATALOGS 
subconmands may be used to specify a subset of the permanent files to be 
deleted, 


This subcommand is useful for the user to manege the users permanent 
file base. If files are being backed up prior to the 
DELETE_CATALOG _ CONTENTS» the list file should be reviewed to insure the 
selected files were accessibie. 


deleta_catalog contents catalog=<cataiog> 
(status=<status_var iabliel 


catalog : c: this parameter specifles the catalog name. 
status: See ERROR HANDLING. 
B1.e2e6 DELETELFILE CONTENTS $ OELETE_LFILE_CONTENT { DELFC 


The purpose of this subcommand is to detete all cycles of a file. 


This subcommand is Intended to be used by the user. The user must be 
permitted an access_mode of (controls read) and a share requirement that 
does not inctude (modifys appends or shorten). 


If a permanent file cycle is busy It wll! be skipped. Busy implies a 
access._mode of read and ai share_mode of (reads execute) may not be 
obtained. Note exclusive access for (modifys shortensand append) iis 
required. 


If the file is in use at the time of the delete the actual delete Is 
not done until the last user detaches the fite. 


Previous EXCLUDE_LFILE» EXCLUDELHIGHEST_CYCLES» INCLUDE _LARGE_CYCLES>» 
and INCLUDE_CYCLES subcommands may be used to specify a subset of the 
cycles to delete. 


delete _file_contents file=<permanent_flle> 


[password=<name>] 
C[status=<status varjable>] 
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fille } f: This parameter specifies the permanent flie name. The 
cyciea numbers if speacifieds is ignored. 


password $ pwt This parameter specifies the file password of the 
permanent file to be deleted. This must match the password 
registered with the file. Omission will cause no password to 
be used. 


status? See ERROR HANDLING. 
Ble2.7 INCLUDE_USERS ! INCLUDE_USER $ INCU 


This subcommand is provided for the system operator. The purpose of 
this subcommand is to select ai subrange of users or famliles to be 
backed up on subsequent BACKUPLALL_FILES subcommand. This atiows the 
installation to organize their backup magnetic tapes onto several sets 
of tapes. This also allows multiple backups to occur simuitaniousiy to 
improve peformance when multiple tape drives and controllers are 
available. If this subcommand is not used prior to the backup ali files 
of all users will be backed up. 


Another benefit of smaller sets of tapes is restartability. If the 
backup must be restarted for some reasons fewer tapes may need to be 
rewritten. 


The EXCLUDE_CATALOG and EXCLUDE_LFILES subcommands take precedence 
ever this command. | 


Include_users users = list range of <catalog> or key ail 
Cstatus=<status vartabie>] 


users 3} user i ut This paremeter specifies an aiphabetic subrange 
of users to be backed up. If only a family name ts specified 
then all users in the family are backed upe Exempfies s:NVE 
will backup all users In family NVE. If a family name ts 
specified as the low value in a range then ali users in the 
family up to the high value will be backed up.» Example: users 
#INVEseitNVE.CKB will backup all users up to and including CK8. 
IF ai family name Is specified as the high value in a range 
then all users from tow value to the end of the family 
specified by the high vaiue will be backad up. Up to 20 
subranges may be specified. If the keyword All is setected 
then the effect of any previous INCLUDE USERS is undone. 


status: See ERROR HANDLING. 
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B1.208 SORTLUSERS ¢§ SORYU 


The purpose of this subcommand is to sort family and user names so 
that the backup will be performed In alphabetical order. This mekes it 
easter to locate user on a backup isting. If this subcommand is not 
issued users will. be backed up tin the order they were created. 


This subcommand may precede a BACKUP_LALL_FILES or a DELETE_LALL_FILES 
subcommand. 


sortlusers Calphabeatical_order=<boolean>] 
Cstatus=<status variable>]} 


aiphabeticallorder  { ao? This parameter indicates whether the users 
are to ba sorted or not on the backup. Omission will cause 
the users to be sorted. 


status: See ERROR HANDLING. 
Ble2e9 EXCLUDE_CATALOG : EXCcc 


The purpose of this subcommand is to direct subsequent backup 
subcommands to exclude the specified cataiog from being backed up or 
deteted. The catalog wil! only be exciuded if the subsequent backup 
subcommand is at a higher tevel in the catalog trees (closer to the 
root)» thus one may override the effects of this by explicitly backing 
up the catalogs or subcatalogs below the specified catalog. This 
subcommand takes precedence over all INCLUDE subcommands. 


This subcommand is useful for excluding files that are instatied aes 
part of the system initialization process. 


exclude catalog catalog=<catalog> 
Cstatus=<status.variable>] 


catalog { ec: This parameter specifies the permanent flie catatog 
that is to be exciuded from beina backed upe The catalog must 
exist. aS 
status: See ERROR HANDLING. 


Ble2e10 EXCLUDELFILE { EXCF 


The purpose of this subcommand ts to direct subsequent backup 
subcommands to exclude the permanent file or permanent file cycie 
specified from being backed up or daleted.s. The file or cycle specified 
widl only be excluded if tha backup subcommand is at.a higher tevel in 
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the catalog structures (closer to the master catalog). The effect of 
this subcommand may be overridden by explicitity backing up the permanent 
file or cycle. This subcommand has precedence over alli INCLUDE 
subcommands. | 


exclude file flitie=<permanent_ file> 
Cstatus=<status_varible>] 


file ! f: This parameter specifies the permanent file or the 
permanent file cycie which Is to be excluded from being backed 
upe The fite must exist. 


status: See ERROR HANDLING. 
Ble2e11 INCLUDE _CYCLES i INCC 


The purpose of this subcommand Is to diract subsequent backup 
subcommands to backup or delete cycles based on the creations tast 
accesss last modifications or expiration date of the cycle. All catalog 
information Is still backed up. If a “before™ criteria (created before, 
accessed _befores modified_befores or expired before) is selecteds then 
only cycles prior to the given date will be backed up. If an “*“after™ 
criteria {(created_afters, accessed_afters modifled_afters expired_after) 
is selected then only cycles after the given date are backed up. 


Two INCLUDE_CYCLES directives may be used to specify a window. Thus 
if one does INCLUDE_CYCLES MODIFIED_LAFTER January 1 1983 followed by an 
INCLUDE_CYCLES MODIFIED_BEFORE January 3 1983 then only cycles modified 
between the two dates specified wil! be backed up. 


Oniy one INCLUDE_LCYCLES subcommand or two INCLUDE_CYCLES subcommands 
that specify a window may be used preceding a backup subcommand. 
CREATED_BEFORE may be used with CREATED_LAFTER»s ACCESSED_BEFORE may be 
used with ACCESSED_AFTER» MODIFIED, BEFORE mey be used with 
MODIFIEDLAFTERs and EXPIRED BEFORE may be used with EXPIRED_AFTER. 
Selection criteria may not be mixed. For example it is not allowable to 
use CREATED BEFORE with EXPIRED BEFORE. 


The INCLUDE_CYCLES subcommand is Intended to provide a partial backup 
capabitity. An INCLUDE_CYCLES subcommand with a MODIFIED_UAFTER 
salection criteria preceding a BACKUPLALL_ FILES subcommand backs up all 
catalog Information. Cycie data Is backed up for files that have been 
wodified after the specified date. The INCLUDE_CYCLES MODIFIEDLAFTER 
and MODIFIED BEFORE subcommands may be used to rebackup a window of 
partial backup dates. 


The INCLUDE_CYCLES with an ACCESSED_BEFORE selection criteria 
followed by a BACKUPLALL_FILES and a DELETE_ALLLFILES subcommands may bea 
used to reduce the size of the permanent file base by deleting permanent 
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file cycles that have not been accessed since the specified date and 


include _cycies selection _criterlazkey of created before, 


created_afters 
accessed _befores accessed_after» ’ 
modified before, modifiedafters 
expired _befores expired afters 
all. 
month=1 «2 12 } JANUARY $! FEBRUARY ! MARCH {$ APRIL $ 
MAY 3} JUNE $ JULY ? AUGUST $ SEPTEMBER $ 
OCTOBER | NOVEMBER ¢$ DECEMBER 
day=1..31 
year=1983..1999 
Chour ?G..23] 
Cminute=9..59] 
Csecond=0..259] 
Cmililsecond=0..999) 
Cstatus =<status _variablie>] 


SELECTION_CRITERIA ! SCt This parameter specifies the selections 


criteria to be used in determining whether the data for a 
cycle will be backed up. This sefection is based on 
statistics maintalned in the permanent fille catalog. 


created before: Onty cycles created before the given dates 
time will be backed up/deleted. 


created_after: Only cycles created after the given dates time 
will be backed up/deleted. 


accessed_before: Jniy cycles whose jlast access was before the 
given dates time will be backed up/ deleted. 
accessed after: Only cycles whose last access was after 
the given date and time will be backed up/deleted. 


modified before: Oniy cycles which were fast modified prior to 
the given date and time will be backed up/delieted. 


modified_after: Only cyctas modified after the given date and 
time will be backed up/deteted. 


expired before: Oniy cycles with an expiration date before the 
given date will be included. If no date is specified the 
current date is used. The retention period may be 
selected on the CREATELFILE or CHANGE _ CATALOG _ ENTRY 
commands... 


expired after: Oniy cycties whose expiration date Is after the 
specified date will be included. 
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ali: This parameter undoes the effect of any previous 
INCLUDE_CYCLES subcommand. No date or time perameters 
may be specified with this selection. 
month i m: This parameter specifies the month. 
day {| ds: This parameter specifies the day of the month. 
year $ y: This parameter specifies the year. 


The next three parameters specify time. Omisston will cause the 
beginning of the day specified by months days and year to be used. 


hour ¢ prt This paramater specifies hour. Omission will cause the 
beginning of day to be used. 


minute i mins This specifies minutes. Omission will cause zero to 
be used. 


second $$ sec: This specifles seconds. Omission will cause zero to 
be used. 


millisecond | msect This specifies alliliseconds,. Omission willl 
cause zero to be used. 


Status! See ERROR HANDLING. 
Examples INCLUDE_CYCLES MODIFIED_AFTER January 1» 1984 
Ble2012 INCLUDE_EMPTY_CATALOGS ! INCEC 


The purpose of this subcommand is to direct subsequent . 
DELETELALL_FILES or DELETE_CATALOG_CONTENTS subcommands to delete (or 
not) any empty catalogs encountered. If this directive is not issued 
prior to a DELETE_LALL_FILES or DELETE_CATALOG_CONTENTS then empty 
catalogs will not be deleted. 


Include empty _catalogs (delete_cataiog= <bool ean>] 
Cstatus=<status_variblie>d] 


delete.catalog i delete _cataiogs { dct This parameter specifies 
whether any empty catalog encountered on subsequent 
DELETE_ALL_FILES or DELETE CATALOG CONTENTS should be deleted. 
Master catalogs will not be deleted. Omission will cause TRUE 
to be used.e 


status: See ERROR HANDLING. 
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B1.2013 EXCLUDE_HIGHEST_CYCLES $ EXCLUDELHIGHEST_CYCLE ¢ EXCHC 


The purpose of this subcommand is to exclude the highest cycles of 
permanent files from being backed up/deteted on subsequent subcommands. 
This subcommand takes precedence over any INCLUDE_CYCLES subcommand. If 
this subcommand precede a backup or delete subcommand then the highest 
cycies of files are excluded. 


This command is useful by the installation and the user to select 
files for backup and deletion. 


exclude highest cycies Cnumber_of_ucycltes20..999) 
Cstatus=<status variabie>] 


number_of_cycles i noc: This parameter specifles the number of high 
cycles to exclude. The range of this parameter is G eo 999. 
Omission will cause 3 to be used. 


status: See ERROR HANDLING. 
B1.2.14 INCLUDELVOLUMES | INCLUDELVOLUME | INCV 


The purpose of this subcommand is to specify that oniy permanent 
files residing on the Included volumes wil! be backed up/deleted on 
subsequent backup subcommands. Any previouly exciuded files will not be 
Included regardiess of device residence. Al! volumes specified must be 
currently active.. 


This be subcommand may be useful in increasing the amount of 
avallable permanent space on a specific volume. Restoring the files 
will cause the files to be spread over all the volumes. 


include_volumes recorded uvsns= tist of <string> or key all 
Cstatus=<status variable>] 

recorded_vsns i recorded.vsn { rvsnt This parameter specifies the 
volumes to Include. The recorded uvsn specified when the 
volume was Initialized must be provided. The recorded vsn is 
a string of up to six alphanumeric characters in uppercases 
If keyword ALL Is specifleds then cycles will not be excluded 
based on device residence. 

status: See ERROR HANDLING. 


Bl.2.15 INCLUDE_LARGE_CYCLES { INCLC 


The purpose of this subcommand is to specify that subsequent 
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backup/delete subcommands shouvtd only include permanent file cycles 
whose size is greater than or equal. to the given size. Any previously 
excluded cycle will not be backed up/ deleted regardiess of cycle size. 


This subcommand is useful when trying to reduce the amount of space 
used on mass storage. Deleting files that are small may cause the user 
a fot of trouble compared to the amount of space that may be obtained. 
Using this subcommand the Instatlation may Ignore smal! files when 
reducing spaces 


Include_large cycies minimum _size=<integer> 
Cstatus=<status varlable>]} 


minimumusize $ ms? This parameter specifles the minimum size of 
flies Included on subsequent backup/delete subcommands. | 


status: See ERROR HANDLING. 
81.22.16 SET_LIST_{IPTIONS $ SET_LIST_OPTION ! SETLO 


The purpose of this subcommand is to specify the information that 
will be displayed to the fist file on subsequent subcommands. If the 
fength of the display line selected Is greater than the page width of 
the tist files additional tines will be used for the dispiay. This 
directive does not affect the DISPLAY_BACKUP_FILE subcommand. 


setlist loptions (file display _options= tist of key accounts as 
projects ps alls» none] 
{cycle display_options= tist of key 
creation _date_times cdt» 
access_date_times adt»s 
modification _date_times mdtys 
expiration_dates eds 
access _counts acy» sizes s» 
recorded uvsns rvysnys 
Qliobal file names gfns 
all» none) 
Cdisplay_excluded_items=<boolean>] 
{Cstatuss<status varlable>1. 


file display options i file display option { fdo: This parameter 
selects data to be displayed with the file name. Data thet 
may be displayed Include the account and project. Omisston 
will cause no data to be displayed. The following keywords 
are used to select displays? 
account { a: Displey the account name. 
projact i p: Display the project name. 
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none: Onty the file name Is displayed. | 
alit Both the account and project name sre displayed. 


cycle _display_options {i cycle display _option i cdo: This parameter 
selects what information will be displayed for each cycle 
backed up ofr rastored on subsequent backup and restore 
subcommands. Additionally the cycle number and if the cycle 
was exciuded will be displayed. The following options are 
avallable: 


creation _date_time i cdt: The date and time the cycle was 
created is displayed, 


access_date_time { adt: The date and time the cycie was tast 
accessed is displayed. . 


modification _date_time !{ mdt: The date and time the cycie was 
last modifled is displayed. : 


expiration date { ad: The expiration dete of the cycle is 
displayed. 


access count {i ac: The number of accesses to the cycle are 
displayed. 


size i si The size of the cycle In bytes Is displayed. 


recorded ivsn i rvysn: The disk volume that the start of the 
cycle resides on Is displayed.. 


global_file.name $: gfn? The internally generated global file 
name generated when the cycle was created is displayed. 
This nama is not backed up or restored, 

nonet Onty the cycle number ts displayed. 

ali: All options are displayed. 


Omission causes modification _datea_time and size to be 
displayed. | 
display_excluded_item i del: If this Is specified as TRUE» then the 
identification of all catalogs» files or cycles excluded Is 
displayed. If FALSE no excluded items are displayed. 
Omission causas excluded Items to be displayed. 


status: See ERROR HANDLING. 
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B1.2017 QUIT : QUI 


The purpose of this subcommand is to terminate the current instance 
of execution of the backup permanent file utility. Control! returns to 
the processor from which the BACKUP_PERMANENT_FILE command was Issued. 


quit 


Bl.3 RESTORE PERMANENT _EILE_2_ RESPE 


The purpose of this command its to Initlate execution of the 
RESTORE PERMANENT FILE command utility. This utility restores permanent 
files and catalogs from backup copies created by the 
BACKUP _PERMANENT_LFILE utility. The restored information will look as it 
did when the backup occurred. Utility subcommands ere used to direct 
the restore operation. 


restore _permanent_file (Ciist=<file raference>] 
Cstatus=<status variabie>] 


fist i 3: This parameter specifles the flie to which a summary of | 
the results of executing the restore utility are written. 
This Includes a list of the names of all files and catalogs. 
that were restored. Omission will cause $LIST to be used. 
Information to be tisted may be selected by using the 
SETULIST_OPTIONS subcommand. If the SET_LIST OPTIONS 
subcommand is not used modification date and times and size 
will be displayed for each permanent file cycle. 


status: See ERROR HANDLING. 

Ble4 RESTORE PERMANENT_EILE_UTILITY SUBCOMMANDS 

The following subcommands are processed by the RESTORE LPERMANENT_FILE 
utility. 
Ble4el RESTORE_ALL_FILES : RESAF 

The purpose of this subcommand is to restore ell catalogs and ail 
permanent files on the specified backup Pile. Backup copies of catalogs 
and files that do not already exist on the ontine devices are restored, 
Catalogs and files that already exist are not altered. 

To restore cha Speten when partial backups heve been fakens this 
command is used to restore the tast partial backup first. This has the 


effect of restoring the catalog structure as it was at the time of the 
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last partial bacios File cycle data which is not contained on the last 
partial backup is restored using the RESTORELEXCLUDED_LFILE CYCLES 
subcommand,. 


restore_all_files seakug F iexceiles 
Cstatus=<status varlable>]. 


backup _file i bf: This parameter specifles the file that contains 
the backup copies of the files and catatogs to be restored, 
The file is initially positioned to beginning of Information. 


status! See ERROR HANDLING. 
Bls4e2 RESTORE_EXCLUDED_FILE_CYCLES ! RESEFC 


The purpose of this subcommand is to restore cycle data for files 
which are cataloged In the permanent file system but do not have data 
definad for them. These cycles must have been created by restoring them 
from a backup file for which cycfte data was excituded by the 
INCLUDE_CYCLES subcommand. The modification date on the backup file 
must match the modification date in the current catatiog for the cycie 
data to be restored. If a cycle already has data defineds it will not 
be altered. 


This subcommand is to be used In restoring cycle data generated as a 
result of partial backups. If the permanent file system is backed up by 
a full backup followed by daily partial backups then the fast partial 
backup is restored with the RESTORE _ALL_FILES subcommand. 
RESTORE _ALL_FILES restablishes the catalog structure as it was at the 
time of the tast partial backup. It restores file data that was 
Included on the partial backup file. File data for the rest of the 
files backed up by the fulll backup and previous partial backups are 
restored by using the RESTORELEXCLUDED_FILE_CYCLES subcommand. This 
subcommand restores fites by matching the modification date in the 
catalog with the modification date on the backup file. Using the 
procedure only filles that were In existence when the fast partiel backup 
was taken are restored. 


restore_axciuded fille cycles € file=<permanent_file> } 
catalog=<catalog>] 
backup_file=<file> 
Cnew name = 
<permanent file> $ <catalog>] 
Cstatus=<status variabie>] 


The first two parameters specify the catalog or file for which data 
Is to be restored. Oniy one of the two may be specified. Omission of 
both will cause al! data to be restored. In this case the new name 
parameter may not be specified. 
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last partial backup. File cycie data which is not contained on the tast 
partial backup is restored using the RESTORELEXCLUDEDLFILE CYCLES 
subcommand. 


restore_all_flles backup. file=<fite> 
Cstatuss<status variable>] 


backup_file i} bf: This parameter specifles the file that contains 
the backup coples of the flles and catalogs to be restored. 
The file is initially positioned to beginning of Information. 


status: See ERROR HANDLING. 
Bl.4.2 RESTORELEXCLUDED_FILE_CYCLES i RESEFC 


The purpose of this subcommand is to restore cycle data for files 
which are cataloged in the permanent file system but do not have data 
definad for them. These cycles must have been created by restoring them 
from a backup file for which cycfe data was exciuded by the 
INCLUDE CYCLES subcommand. The modification date on the backup file 
must match the modification date In the current catatog for the cycie 
data to be restored. If a cycie already has data defineds it will not 
be altered. 


This subcommand Is to be used In restoring cycle data generated as a 
result of partial backups. If the permanent file system is backed up by 
a full backup followed by daily partial backup», then the last partial 
backup is restored with the RESTORE_ALL_FILES subcommand. 
RESTORE_ALL_FILES restablishes the catalog structure as It was at the 
time of the tast partial backup. It restores file data that was 
Included on the partial backup file. Fite data for the rest of the 
files backed up by the full backup and previous partial backups are 
restored by using the RESTORELEXCLUDED_LFILE_CYCLES subcommand. This 
subcommand restores files by matching the modification date in the 
catalog with the modification date on the backup file. Using the 
procedure only files that wera In existence when the fast partie! backup 
was taken are restored. 


restore excluded file.cycies € file=<permanent file> } 
| catalog=<catalog>) 
backup _file=<file> 
[new name = : 
<permanent file> $ <catalog>] 
Cstatus=<status variabie>] 


The first two parameters specify the catalog or file for which data 
ts to be restored. Qniy one of the two may be specified. Omission of 
both will cause alt data to be restored. In this case the new name 
parameter may not be specified. 
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file | f: This parameter specifies the permanent file or permanent 
file cycle on the backup file that Is to be restored. If no 
cycle number is specified then data for ali cycles of the file 
will be restored. Cycle number If specified must be a 
specific cycie not S$HIGH or $LOW. 


catalog | c: This parameter specifies the catalog as identified on 
the backup file. Data for all cyctes In this catalog will be 
restorad if a matching catalog entry exists with no datas 


backup _file : bf: This paremeter specifies the file containing the 
backup information. This file ts positioned at the beginning 
of information, . 


new name } nan i new file name } nfn { new catalog name i nent This 
parameter specifies a new name for the catalog file or cycle 
for which data is to be restored. This may be used if the 
name on the backup file Is different then that In the current 
permanant file system. Omission will cause the name as iit 
exists on the backup file to be used. If a cycle reference 
was included on the file parameter but not on the new name 
parameter then $HIGH Is used. In general this parameter 
should never have to be used by the Installation or the usere 
It Intent ts to match the parameters on the RESTORE _CATALGG 
and RESTORE_FILE subcommands allowing change of catalog names 
to occur when working with partial backups. 


B1.4.3 RESTORE_LEXISTING_CATALNG $ RESEC 


The purpose of this subcommand is to restore an existing ontine 
cataloge Backup copies of files and tower level catalogs/files that do 
not atready exist in the specifled online catalog are restored. Any 
item that exists online Is not altered. 


restore existing catalog catalog=<catalog> 
backup_flle=<file> 
{new _catalog name=<f ile>] 
Cstatus*s<status varlable>] 


catalog : c: This parameter specifles the cetaiog as identified on 
the backup file that is the base for the restore. 


backup_file i bf: This parameter specifies the file that contains 
the backup copy of the catalog and its associated files and 
subcatalogs/fites.. Information must have previously been 
written to this fille by the BACKUP_LFILE» BACKUPLALL_FILES or 
BACKUP_CATALOG subcommands. The file Is positioned at 
beginning of information. 
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new_catalog name { nen: This parameter specifies the existing 
online catalog Into which the files and subcatalogs on the 
backup file are rastored.e Use of this parameter atliows the 
contents of a catalog on the backup file to be restored in an 
oniine catalog with a different name. Omission will cause the 
name as it exists on the backup file to be used. 


status: See ERROR HANDLING. 
B124e4 RESTORE_CATALOG } RESC 


The purpose of this subcommand is to restore a catalog that does not 
currentiy exist online. Backup copies of the catalog and all its 
associated files and subcatalogs are restored. Oniy a system operator 
or the owner of the resulting ontine catalog can request this function. 
The catalog can be restored with the name It had at the time it was 
backed up or under anew name. The resulting catalog must be uniaque 
relative to the catalog in which it Is registered. This command cannot 
be used to restore a user's master catalog. 


restore _cataliog catalog=<catalog> 
backup_Ffille=<file> 
Cnew catalog names<catalog>] 
Cstatus=<status varlabfie>] 


catalog { c: This parameter specifies the catalog as Identified on 
the backup file that is the base for the restore, 


backup_file 3: bf: This parameter specifies the file containing 
backup information. It must have been previously written by 
the B8ACKUPLALL_LFILES or BACKUP_LCATALOG subcommands. The file 
is positioned at beginning of information. 


new catalog name { nen: This parameter specifies a new name for the 
catalog being restored. If this new name Is not a unique name. 
relative to the catalog in which it Is registered an error 
status is returned. Omisston wild cause the name as it exists 
on the backup fille to be used. 


status: See ERROR HANDLING. 
B1.24.5 RESTORE EXISTING FILE : RESEF 
The purpose of this subcommand Is to restore file cycles of an 
existing online file. All fille cycles that exist on the backup file but 
that do not exist online ara restored. Cycles that exist online are not 
aitered.. A user with cycte permission to the online file can request 
this function. . 
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restore existing file file=<filte>d 
backup _fille=<file> 
Cpassword=Cname>d) 
Cnew file name=<file>] 
Cstatus=<status variablie>] 


file $ fs: This parameter specifies the permanent file as identified 
on the backup file whose cyctes are to be restored. If a 
cycle referencsa Is Included it Is ignored. 


backup_file i bf: This parameter specifies the fite containing 
backup information. It must have previously been written by 
the BACKUP_PERMANENT_FILE utility. The file is positioned at 
beginning of Information. 


password { pwt This parameter specifies the file password. It must 
match the existing file password.. Dmission will cause no 
password to be usad. 


new filename i nfn: This parameter specifies an existing ontine 
file to be restored. Use of this parameter allows a permanent 
file to be restored under a different file name than exists on 
the backup. If a cycle reference is Includeds it is ignored. 
Omission will cause the neme as It exists on the backup file 
to be used. 


status: See ERROR HANDLING. 
Bl.24e6 RESTORE_FILE { RESF 


The purpose of this subcommand Is to restore file cycles that do not 
currently exist online. If the file name includes a cycie reference 
onty that cycle will be restored (at least one file cycle must exist). 
If a cycle reference is omitted all file cycles will be restored (the 
fille must not already exist). If Included It must specify a specific 
cycle numbers, $HIGH or SLOW cannot be used. The file can be restored 
with the name it had at the time It was backed up or under a new namee 
The resulting name must be unique relative to the catalog In which it Is 
registered. Only a user with cycle permission to the online catalog can 


restore all file cycles. Qniy a user with cycle permission to the file | 


can restore an additional file cycle. 


restore_file fFile=<file> 
backup _file=<flle> 
Cpassword=<name>] 
Cnew_ file _name=<fi}le>) 
Cstatus=<status variabta>] 


file } fi This parameter specifies the permanent file as identified 
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on the backup file. 


backup file =} bf: This parameter specifies the file containing 
backup Information. It must have been previously written by 
the BACKUP_ALL_FILES» BACKUP CATALOG or BACKUP_LFILE 
subcommands. The file is positioned at beginning of 
information. 


password { pw: This parameter specifies the file password. It must 
be provided If a specific cycle of an existing oniine file is 
being restored. It must match the exsting file password. 
Omission will cause no password to be used. 


new fillie.name {| nfn: This parameter specifies a new name for the 
file being restored. If a cycle reference Is not Included on 
this parameters but was included on the fite parameter then 
SNEXT wlll be used. If this name Isn't a unique name relative 
to the catatog in which it Is registered an error status is 
returned. Gmission will cause the name as it exists on the 
backup. file to be used. | 


Status: See ERROR HANDLING. 
81.4.7 SETLLISTLOPTIONS 7? SETLO 


This subcommand Is avallable as described in the backup section, 


B1.2403 DISPLAY BACKUP_FILE ! DISBF 


The purpose of this subcommand is to display the contents of a backup 
file. Information is displayed about catalogss filess and cycies which 
have been backed up onto the specified backup file. The caller may 
optionally select to display header Information maintained on the backup 
filles and may also direct the subcommand to attempt reading of ati data 
on the backup file. The caller may compare this result with the backup 
listing to verify that everything backed up may be read successfully. 


This subcommand Is useful to the Installation and the user to 
determine exactiy what Information is contained on a backup file. } 


display _backup_flile backup _fillie=<file> 
Cdisplay_option= key identifiers i» 
. descriptors, ds» read datas rd] 
Cnumber=<integer> or key alti 
Cstatus=<status variable>] 


backup _file i bf: This parameter specifies the file that contains 
the backup copies of the flies and catalogs previously backed 
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up by @ backup utility subcommand. 


display option i do: This parameter specifies the tevel of 
information to be displayed. Vatid specifications are: 


identifier { i: Selects a display of the name and type of each 
entry on the specified backup file. 


descriptor i d: Seteacts a display that includes: description 
of the record headers maintained on the beckup files the 
version of the backup permanent files utilities producing 
the backup files The date and time the backup file was 
writtens as well as the backup _permanent_file subcommand 
producing the backup files and for each cycie of each 
flle on the backup file the following: cycle numbers 
usage counts creation date and times tast access date and 
times tast modification date and times expiration dates 
and cycle size. 


read_data i: rd: [In addition to the descriptor display an 
attempt Is made to read all data for each cycle on the 
backup file. The tisting reports whether the data is 
read without error. No attempt Is made to verify the 
data with the original fila backed up. e 4 


Dmission will cause Identifier to be used. 
number | nt This parameter selects the number of catalogss files» 
or cycles from the beginning of the backup files for which 
information is to be displayed. If this parameter is omitteds 
or ALL Is specifleds then all entries on the backup file are 
displayed. 
status: See ERROR HANDLING. 
B1.4.9 QUIT } Qut 
The purpose of this subcommand is to terminate the current instance 
of execution of the restore permanent file utility. Control returns to 
the processor from which the RESTORE_LPERMANENT_FILE command was issued. 


quit 
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A5.5.1 DESCRIPTIVE_DATA PORTION OF STATISTIC «© 2 0 2 2 © 0 0 A5-4 
A5eDe2 COUNTERS PORTION OF STATISTIC > © 2 8 *@ 8 © © &@ © 8 @ ® A5-4 
ADde5e2el System Action ~ 350060 oo 2. © * ©» © @© © © © © © © @ A5<-5 
A5e5e20e2 Software Fallure —- 350001 . . 2 © 0» © © » © © © @ A5-5 
A5e5e203 7154 Failure — 350062 « « + »= © © © © © © © ow wo 8 A5~-6 
A5e5e204 7155—1x Fallure — 350603 oo 2. * © © © © @ © © #® @ ® A5-8 
A5eG TAPE-RELATED STATISTICS 2» « 0 0» © 2 © © @ wo oO oO wo wo wo wo A5=-8 
A5e6ei DESCRIPTIVE_DATA PORTION OF STATISTIC « » 0 © © © © © @ A5-9 
A5e622 COUNTERS PORTION DF STATISTIC 2 « » © © © 9 8 82 2 © © 8 A5-9 
AdeGe2el 7O21—3x Fallures - 351002 « « © © © 8» © © © 8 @© ® @ A5-10 
A6.0 FAILURE ANALYSIS » © © © © © © © © © © © © © © © © 8 © 8 Aé-1 
A720 RECONFIGURATION 2. 0 © 2 0 © © © 2@ © 8 © 8 9 9 © © © &@ © @ 2@ A7-1 
A7Vel ASSUMPTIONS 2 « 2 2 0 2 © © © © © © © 9 © © © 8 8 2 8 8 8 AT-1 
A7e2 FAILURES NOT REQUIRING RECONFIGURATION «2 «© © © © © ©» @ @ @ A7=-1 
A723 CONFIGURATION #1- SINGLE CONTROLLER » 2s > *» @ @ © 2 8 @ . A7-1 
A7e3.1 DISK RECONFIGURATION SCENARIOS . 2 0 «© © © 2 © © 2 @ A7=-2 
A7e3e2- TAPE RECONFIGURATION SCENARIOS *o 2 *@ © © @ @ &@ © &@ ® @ A7=-6 
A7.%4 CONFIGURATION #2 —- MULTIPLE CONTROLLERS 2 © 2 © 0 © © © » © A7~8 
A7e4el DISK RECONFIGURATION SCENARIOS 2. » «6 © © 2 © © 80 @ @ 28 A7=8 
A7e4e2 TAPE RECONFIGURATION SCENARIOS so 02. 2 @ © © @ *® 8&8 @ @ @ AT-9 
Appendix 8B NOS/VE Permanent File Utilities 2 * © © © 8© © © @ B=1 
B1.0 PERMANENT FILE MANAGEMENT 2 «© «© 09 © 2 0 © © 89 © wD eo © © @ Bl-1 
~B1.l BACKUP_PERMANENT_ FILE H BACPF * * © @ *® 2£© ® *® © @ & 8 8 ® ® Bl-1. 
B1le2 BACKUP_LPERMANENT_FILE UTILITY SUBCOMMANDS « «© 0 © 2 © © © 2 Bl=-2. 
Ble2el BACKUP_LALL_FILES : BAC AF * 2 © *» © 2 2 © @ @ © © © ® @ Bl-2 
BleZ2e2 BACKUP _CATALOSG 3 BACC 2 2 © 2» © @ 2s 2 2 @ © © © @ © © B1-3 
B1.2.3 BACKUP_FILE $ BACF os 0s © 8 0 © eo eo oe we ee we B1l-%4 
Ble2e% DELETE_LALL FILES » + @¢ * #® @ @ ®# 8 8 *@ 8 2 @ &© 09 ®@ ® @ Bl=5 
Ble2e5 DELETE_CATALOG_CONTENTS ¢ DELETE_CATALOG_CONTENT 3 
DELCC 2:0 © 0 2 09 0 0 09 8 0 ' 0 28 #0 0 00 8 88 et 8 8 Bi-5 
B1.e2e6 DELETELFILE_CONTENTS $ DELETELFILE_CONTENT $ DELFC «2 « B1l~6 
Ble2.7 INCLUDE_USERS + INCLUDE USER H INCU *s 2 + @ @ © & © 8 @ Bl-7 
Bi1.2.3 SORTLUSERS 3 SGRU 2.2.2 2 0 0 © © © @ @ > 2 * © 2 &@© @ @ Bi-8 
B1.209 EXCLUDE_CATALOG 3 EXCC 2. 6 «© © © © © @ © ow eo ow ww 8 B1l-8 
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B1.2-10 EXCLUDE_FILE ; EXCF 7-2 2 2 2 @ © © 8© #@ © © &© © &@ 9 28 Bl-8 
B1l.2e12 INCLUDE_CYCLES H INCC a *@ @ @ @ @© ®@ @ © *® © @ © © @ ® Bi-9 
Ble2el2 INCLUDELEMPTY_CATALOGS { INCEC « 2 0 2» 2» © © 0 0 wo Bl=11 
Ble2013 EXCLUDE_HIGHEST_CYCLES $ EXCLUDE _HIGHEST_CYCLE % EXCHC Bl-12 
B1.2014 INCLUDE_VOLUMES { INCLUDE_VOLUME $ INCV 2. 0 © 0 0 «© « B1-12 
B1.2.15 INCLUDE _LARGE_CYCLES H INCLC > 2 @ 2» © © 8 © *@® © © © @ Bl-12 
B1.2e16 SETLLISTLOPTIONS ¢$ SETLLISTLOPTION 3 SETLO 2. 2 2 © « « Bi-13 
Bl. 2017 QUIT } aut ® > *® » s »s *® » ® »* * » » d » 2 » fd * ® 2 B1l—15 
B1.3 RESTORE_ -PERMANENT_ FILE ? RESPF » 8 »*® oo 2 © 8 © © @ © 8 @ B1-15 
B1l.4 RESTORE PERMANENT FILE UTILITY SUBCOMMANDS > 2 2 © ©» © © 8 B1-15 
B1.4e1 RESTORE ALLL FILES ; RESAF « 2© «0 » 8 » > 2 2 + © *@ © @® @® B1l-15 
Ble4eZ RESTORE_LEXCLUDED_FILE_CYCLES : RESEFC 2 2 « 0 © © © © @ B1-16 
Ble4e.3 RESTORELEXISTING_CATALOG { RESEC 2. « © ©» © © © © © @ 2 B1il~17 
B1.4e4 RESTORE_CATALOG ; RESC > 2 * 28 @ © © @ © &@ * © &® @ 8 © B1-18 
Ble4e5 RESTORELEXISTING_FILE $ RESEF 2 « » 2 © © 2» © © © @ © 2» Bi-18 
B1.4.6 RESTORE_FILE : RESF + 2©« © © 0 © © © © © 0 8 © © 0 Bi-19 
Bl.4e7 SETLIST UOPTIONS H SETLO oo 02 @ © © © *® @ &@ @ 82 8&8 © @ ®@ B1-20 
B1.4e3 DISPLAY_BACKUPLFILE { DISBF . 2 « 2 «© © 2 © 2 2 oe wo 2 B1-20 
8124.9 QUIT : Qui * 2 © © © @ @ ®@ @ @ © © &@© 2 2 © #@ © @ © @ ® Bi-21 
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Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 
Err 


\*¥asis 


? 
**PREVIOUS COMMAND PRSECUGNEZED 
\t¥asis 

? 
**PREVIOUS COMMAND UNRECOGNIZED 
\= 

? 

**NEST DOES NOT EXIST 

\*asis 


? 
**¥PREVIOUS COMMAND UNRECOGNIZED 
\¥asis 

? 


**¥PREVINUS COMMAND UNRECOGNIZED 
\*asiIs 


? 
**PREVIOUS COMMAND UNRECOGNIZED 
\*¥asis 


? 
*¥*PREVIOUS COMMAND UNRECOGNIZED 
\¥asis 


? 
**PREVIOUS COMMAND UNRECOGNIZED 
(m. 


? 
*eNEST DDES NOT EXIST 


